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3 aspberry Pi is unlike any other computer. On the one hand, it’s 


a fully powerful desktop computer, at a fraction of the regular Lucy 

cost. At the same time, thanks to its educational roots, Raspberry Hattersley 
Pi is ready to become just about anything. Everything from solar- Lucy is editor of 
powered boats (page 8) to cheese-grilling machines (page 16) can be E 
found inside this magazine. aiid eat ate 

Maybe you’ve got an idea for something to make. In which case E 

our 50 Tips & Tools for Raspberry Pi feature (page 26) will help you EE 
kit out for 2020. This year could be your chance to finally build your ee 
crazy contraption. 


If, like me, you’ve no idea what to make next, then take a look at our 
Raspberry Pi A accessories guide (page 68). Here you’ll find kits and 
gadgets that can inspire you to build a friendly project. 


I believe 2020 is going to be an incredible year for technology and RASPBERRY 
making, and The MagPi sits at ZERO W KIT 
the heart of the most creative W ern Yeon x 


community on earth. This magazine 
is packed with incredible ideas and 
builds engineered by some of the 
most fun people we know. 

Here’s to another decade 
of making. 
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DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the read i e e responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 
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A Akestrel captured at night-time using 
Raspberry Pi NolR infrared camera 


The Nest Box | 
live-streams garden birds 


This Springwatch-inspired nest box is used to lure Facebook 
users, such as Rosie Hattersley, away from cute cat videos 


A APIR sensor and 
camera fitted toa 
kestrel box 


The CAD design for 
the plastic tray at the 
top of a bird-box 


cute animals doing adorably cute things — or 

just being cuddly and wholesome. Click 
‘like’ and share the heart-melting gorgeousness 
of the latest viral video. No wonder The MagPi 
magazine reader Jamie Wainwright’s live stream 
of chicks in a nesting box caught our attention 
when we asked you about Raspberry Pi projects. 


| t’s a tried and tested social media formula: 
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Liverpool-based Jamie introduces viewers to 
the cute residents of The Nest Box using 
impressively high-quality images and video from 
three Raspberry Pi-enabled British bird-boxes, 
with three more being set up. 

These train video cameras on a kestrel box and 
also a barn owl box after Jamie proposed the 
camera feed to the Wirral Barn Owl Trust. 


Instant replay 
Throughout spring, all the cameras stream live to 
The Nest Box’s 5500 Facebook wildlife fans 
(magpi.cc/nestbox). Out of season, visitors can 
enjoy a short movie recapping events from the 
nests earlier in 2019: magpi.cc/nestboxmovie. 
Jamie says one of the beauties of The Nest Box 
setup is that it requires so little equipment: a 
Raspberry Pi and Camera Module, along with a 
Raspberry Pi PoE HAT (magpi.cc/poe) to provide 
both power and internet connectivity, so there’s 


MéigPi 


The design for the kestrel 
box, with the camera in 
the lower section 


only one cable connection to weather-proof. A 
custom HAT controls LED lights and the 
Raspberry Pi Camera Module, providing high- 
quality images day and night. Python code 
records visitors to the nest boxes. This causes the 
Facebook feed to go into live streaming mode 
whenever there’s any nest box action. 


Creature comforts 

Thanks to some successful crowdfunding, Jamie 
was able to add sound via USB microphones 
attached to the Raspberry Pi rig. Furthermore, a 
schematic on The Nest Box’s GoFundMe page 
(magpi.cc/nestboxfund) shows the smart 
bird-box’s electronics hidden away in a small 
plastic box, with a fan to help keep everything 
cool during operation. 


Facebook goes into live streaming mode 
whenever there's any nest box action 


Each installation has 
a different design 
depending on the 
bird being monitored 
- this one is for the 
barn owl box 


A 3D-printed section 
for the barn owl box 


The Nest Box live-streams garden birds magpi.cc 
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Observation System. 


What computer do you use when you want to have a solar-powered, autonomous boat 
that measures water guality? Rob Zwetsloot discovers that the answer is Raspberry Pi 


08 


Murray 
Lowery- 
Simpson 


Although coming 
from an engineering 
background, 

Murray has been 
developing 
software for a little 
over 20 years. 


AMOS will be useful 
to researchers, anda 
good base 

for hobbyists 


magpi.cc 


here are many basic rules when it comes to 

electronics. One of them is that water and 

electronics don’t mix, even if your average 
smartphone is able to take a brief dunk in the sink 
these days. So when someone comes to us talking 
about a waterborne project, we listen — and that’s 
exactly what happened when Murray Lowery-Simpson 
emailed us about his solar-powered boat. 

“My project is named AMOS (Aquatic Mini 
Observation System),” Murray tells us. “It is a solar- 
powered, autonomous airboat for measuring water 
quality over large, distributed areas.” 

Murray has worked on a couple of prototypes for 
the boat. The first one was made out of a kayak beer 
cooler (a small kayak that acts as a beer cooler) and 
had propellers that would end up getting gunked up. 
He also tested distance measuring with a Raspberry Pi 
Compute Module’s stereo vision before settling on a 
lidar module and a Raspberry Pi 3B+. 


Aquatic Mini Observation System 


“During this past winter, I built a second 
prototype, this time using a longer surfboard- 
type design constructed from glued-together 
insulation foam that was given a coat of fibreglass 
to give it some added strength and stiffness,” 
Murray explains. “Instead of the water propellers, 
a single 10-inch drone propeller and motor were 
used and connected to a small waterproof servo 
motor at the stern end of the boat. This design was 
lighter (about 13 kg) and longer, and although the 
air propeller only produced about a tenth of the 
thrust provided by the dual water propellers, the 
improved draft and hydrodynamic shape made it 
slightly faster in the water.” 

A Raspberry Pi controls the speed and angle of 
the air propeller, takes sensor readings from the 
water, interacts with the lidar module, and has 
several other functions so that it knows its speed 
and heading. 


The boat is fully 
automated and, on 
a sunny day, fully 
self-sufficient 


Quick FACTS , 


Murray got into 
robotics in late 2017 


He was inspired by 
local news about 
A lidar and camera pollution on 


aid in navigation public beaches 


AMOS tests pH, 
salinity, dissolved 
oxygen, turbidity, 


H and more 
A suite of sensors check the 


ter's chemistry - it 
water's chemistry - soon i Bictures#eniathe 


Camera Module 
are mostly used to 


4 
p 
\ will test for bacteria 
f 
J \ V locate a lost AMOS 
ra 7 


X e . AMOS can 

- be controlled 
OAS Z. N s 7 by iOS and 
e A ` ` Android devices 


d The old version was 
a bit slower and 
stubbier, and the fans 
would get weeds 
stuck in them 
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This photo gives you ap H H 
ea cee ot Pm hoping that AMOS will be used for water 


the boat testing by environmental services companies, and 
industrial customers such as mine operators that 
may be required by law to confirm that pollution 
imits in bodies of water surrounding their 
operations are not exceeded,” Murray reveals. “I’m 
hoping also to be able to offer it at an attractive 
price point, with modular components so that 
researchers or robotic boat enthusiasts could also 
use it, or some subset of it, in their own projects.” 


Approximately 150 km of testing has been 
completed on the second AMOS prototype 


Major tests 
The prototypes aren’t just proofs of concept, 
either: they’ re fully functioning test beds, as 
Murray explains: “Approximately 150 km of testing 
has been completed on the second AMOS prototype 
in 2019. It can work well in shallow water (as little 
as 2cm depth) and can travel through regions of 
water with lots of grass or other vegetation without 
any worries about getting stuck. Its airboat design 
works best under conditions of low wind (less than 
20 km/h) and it can travel at a top speed of about 
2.7 knots (5km/h). Provided the sun is shining on 
a clear day and higher than about 40 degrees in the 
sky, AMOS can run at top speed without depleting 
the charge of its battery.” 

Murray plans for AMOS to be on sale in the 
summer, so you don’t have too long to wait. 


Our interview with Murray covered many more topics 
we couldn’t squeeze into the magazine, so please look 
out for the full transcript at magpi.cc/amos. 


10 magpi.cc Aquatic Mini Observation System 


MägPi 


Testing the waters 


A boat needs to be launched. You can control 

the destination using a smartphone; there are 
apps for Android and iOS that you can find on the 
GitHub page: magpi.cc/amosGH. 


Using a combination of GPS, lidar, and 

cameras, the boat navigates its way around 
waterways and rivers. This allows it to obtain a 
big sample from any given area, and see how it 


We think the AMOS changes throughout. 
looks quite majestic 
as it pootles about 


AMOS also works 

in cold weather, 
although a lack of sun 
means it can't operate 
for long 


The surfboard body 
makes it light, and its 
length allows for a 
large solar panel 


On a sunny day, it can happily take readings all 

day without too much interference. On a cloudy 
day, it may only operate for up to an hour. Although a 
bigger battery might solve this, it will be heavier. 


Aquatic Mini Observation System magpi.cc U 
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Organnery 
pipe organ 


A French company is marrying broken electronic pipe 
organs with a Raspberry Pi, and finding it's 0 match 
made in heaven, as David Crookes discovers 


Daniel 
James 


Daniel James is 
the director of 

64 Studio Ltd, 
which produces, 
integrates, and 
documents free 
and open-source 
software for media. 


organnery.com 


hen it comes to the work of Audiotronic 
W founder Raphaël Mouneyres, silence is 

most certainly not golden. Given his job 
entails the repair of electronic pipe organs, a lack 
of sound points to a major problem - one that’s 
happening more often and becoming trickier to 
resolve using original parts. 

Raphaël tell us that he increasingly found 
components for first-generation digital pipe 
organs — many of which are installed in churches 
across the world - to be either obsolete, expensive, 
or simply unobtainable, threatening to consign 
many an instrument to the scrap-heap. 

The solution has been to strip the organs of their 
old electronics and replace them with something 
new. “After some thoughts and calculations, we 
came up with a method that would retain the 
console, keyboard, and controls and instead make 
use of a small, affordable, and efficient single- 
board computer,” he says. 


acolus 0.9.8 for organnery 


8 kee — 1 -— em "ES g S 


A The Aeolus software allows a collection of stops to be saved to a 
USB memory stick for each organist 
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A Digital organs have been used in place of pipe organs 
within churches for a while, but damp and the scarcity 
of spare parts mean they're not lasting as long 


The chosen device was a Raspberry Pi, selected 
because of its worldwide availability, strong 
development community, and affordable price. It 
offered a perfect way of bringing pipe organs back 
to life so that they can be played as before, while 
allowing modern options such as a touchscreen. 

“There are lots of good HATs available covering 
sound output, MIDI, and control interfaces,” says 
Daniel James, boss of 64 Studio, the company 
tasked with creating the software. 


Fine tuning 

As such, Daniel and colleague Chris Obbard began 
to work on a customised Debian GNU/Linux image 
called Organnery that made use of the open-source 
classical organ modelling software Aeolus and 
Raspberry Pi’s capabilities. With eleven different 
temperaments, variable tuning, three or more 
manuals, and a pedal board, as well as MIDI in/out 
control and the flexibility to play different sounds, 
a personalised experience is possible. 

“Organnery needed to be set up as a single-use 
appliance, and the requirements came directly from 
the organists we’ve been working with to refine 
the system,” Daniel says. “We made adjustments 
to the Aeolus source code as well as to supporting 
programs. These included Mididings, a scriptable 
MIDI router and processor written in Python.” 


PROJECT SHO! E 


Normally, a Raspberry 

Pi is fitted inside the be 
electronic organ but this l 
is an earlier prototype of 


the Organnery project sà 
kd 
kd 


If the organ has a MIDI output, it can be 
transformed into an Organnery with a 
plug-and-play expander, otherwise a 
technician will need to specially retro-fit it 


Nf 


A touchscreen display can be used 
to control the Aeolus software - one 
organ console can accommodate 
different styles of sound 


N 
NY 


CSR, Quick FACTS 


N ` 
ON. D 
SW Ki d > Humid and 
$ À 
Œ cold churches 


mean organ 
electronics suffer 


Daniel also created minimal system images 
based on Debian Buster using Dibby, which is 
a collection of scripts that leverage the distro’s 
packaging tools. “This approach was a far leaner 
and more reproducible way to build appliances 
than starting from a standard image and stripping 
the system down,” Daniel says. 


v 


Retro-fitting a 
Raspberry Pi 
revitalises 
broken organs 


v 


Organnery can be 
a MIDI expander for 
new sounds too 


Retro hits 

So what’s the verdict? “Organnery offers a major 
sound upgrade since the sound produced by the 
Aeolus software is of a much better quality than 
digital electronics from the 1980s,” Raphaél says. 


It runs Aeolus, 
allowing hundreds 
of potential controls 


v 


A touchscreen can 


v 


A The MIDI switches of an organ are being retro-fitted with new 


“It gives the organ player access to new ‘pipes’ electronics, powered by Raspberry Pi also be fitted 
and complete control over sound placement in 

space, from a standard stereo system up to 3D make learning the classical organ much more 

Ambisonic diffusion.” accessible than it has been in the past.” 

Most Organnery systems are being retro-fitted Even so, bringing organs back to life, complete 
into existing organs, but the system can be built with the original woodwork and physical controls, 
from scratch using standard and affordable MIDI is perhaps most satisfying. “Church organ consoles 
hardware. “Some of the smaller organs made for are also often made of expensive hardwoods so 
the domestic market have a five-pin MIDI Out we are Saving trees,” Daniel says. For organists 
socket and can be obtained for next to nothing,” used to the age-old interface of their instruments, 
Daniel explains. “Aeolus and Organnery can also that’s sure to be extra music to their ears. M 
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Airdrum 


This drumset can be played with a hover of your hands 
and gives visual feedback too, as David Crookes learns 


e’re always going to beat the drum for 
W projects that seek to improve the lives 

of people with severe disabilities. To 
that end, we fell in love with the Airdrum, which 
was created to allow anyone - in particular those 
with a mental or physical condition — to playa 
traditional instrument. 

Designed by two Dutch electrical engineering 
students, Alessandro Verdiesen and Luuk van 
Kuijk, the project came to life during their first 
year at university. “We aimed to develop a musical 
instrument that could be used to generate music 
by moving,” explains Alessandro, who has recently 
been working on a fully modular version 2.0. 
Alessandro After speaking with therapists and health care 
rire institutions, the pair decided to make a drum that 

UUK venue could be played by moving objects above a set of 
panels and they put a Raspberry Pi at its heart. 


E 


Alessandro is an 


electronics engineer “The basic functionality of the Airdrum is to detect 

S a ee Ee the distance of an object above each connected 
ge ee panel and play a sound,” says Alessandro. “These 

systems, while ` ` 

Luuk is studying panels contain IR distance sensors and coloured 

for his master's LEDs for visual feedback.” 


degree in next level 
engineering. 


Sorting the bass-ics 

From the outset, Alessandro and Luuk needed their 
project to be accessible, affordable, adjustable 

and, in the latest iteration, modular, with each 
drummable section containing an Arduino Mini, 

an IR sensor, and LEDs. They also wanted the 


magpi.cc/airdrum 


P A lot of meticulous 
planning has gone 
into the creation of 
the Airdrum over the 
past few years 
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A Custom-made Airdrum detecting modules fit snugly into their 
3D-printed cases and can be arranged in a full circle if you have 
enough of them 


instrument to have a broader appeal and be 
suitable for everybody, including professional 
musicians, so it had to sound as good as it played. 

“We needed it to be as versatile as it can be and 
allow people to choose custom sounds, colours, 
and lights while being a standalone instrument and 
a multi-purpose input/output device,” Alessandro 
reveals. To make it easy to place the modules 
together, they used magnetic connections between 
the panels. This allowed them to be placed together 
in various configurations, with a minimum of two 
per Airdrum. 

With a structured plan that divided milestones 
into electrical, mechanical, and software 
components, the pair used 3D printing for the 
enclosure, which enabled rapid prototyping for 
quick interactions. They used speaker panels to 
bookend the modules for auditive feedback. 


Panel beating 

Each of the panels includes a buck converter 

so that the current through the connectors can 
be drawn to a minimum. The master module 
panel contains a Raspberry Pi 3 running custom- 
made programs written in C and Python, as well 


This master module panel packs a 
sensor, LED, Arduino Mini, and buck 
converter, as well as a Raspberry 

Pi which generates the sound and 
lends the project Bluetooth/ WiFi, 
aux-out, and USB capabilities 


When a hand or other 
object is passed over 
the top of a module, it 
lights up and plays a 
sound. Speakers can be 
placed to the left and 
right of the modules 


D it also has obt bus to 
act as a data transfer 
master unit Ø 


as the free open-source software synthesiser 
FluidSynth. It connects to the other panels 
through PC, constantly polling the panels for 
their measurements and for the configuration of 
their colour. 

“Tf an object has been detected, the Raspberry 
Pi generates a sound and outputs it on the AUX 
audio jack,” says Alessandro. “This output is then 
used by the mono D-class amplifiers in the speaker 
panels to make the tones audible.” 

The pair chose a Raspberry Pi because of its 
versatility and technical prowess. “The Airdrum 
needed something powerful enough to run 
software to generate audio through MIDI using 
the input from the panels and the Raspberry Pi 
is a great universal and low-cost development 
board with integrated DAC for audio,” explains 
Alessandro. “It also has a PC bus to act as a data 
transfer master unit and they’re compact enough 
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to fit inside of the casing. The Raspberry Pi enables 

easy implementation of future upgrades, too.” 
Indeed, the pair want to explore the MIDI 

possibilities and connect the Airdrum witha 

smartphone or tablet. An app is being planned, 

as is a built-in synthesiser. “The people we 

have shown the Airdrum to have been very 

enthusiastic,” Alessandro says. “That has been 

very motivating.” Hl 


Each one of these interchangeable 
modules has a drawer in the 3D 
casing for the Arduino Mini, sensor, 
buck convertor, and battery, and 
they're connected with others 
using magnets 


d These speaker modules 
can bookend the sensor 
panels, although the 
sound can be outputted 
via the Raspberry Pi 
to a different sound 


system too 


> Disabled people 
can play without 
holding it 


> Anew modular 
design makes 
it versatile 


> It can play MIDI files 
via a Raspberry Pi 


> The designers also 
want pro musicians 
to enjoy it 


> A basic two-module 


Airdrum would cost 
about £120 
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Cheeseborg 


In wintertime, what could be more comforting than a grilled cheese sandwich? 
Cheeseborg uses Raspberry Pi to serve them up, as Rosie Hattersley smacks her lips 


Taylor studied 
mechanical 
engineering at 
Carnegie Mellon 
University, exploring 
how people interact 
with hardware, and 
thinks Raspberry Pi 
is the ideal platform 
for this. He now 
works for creative 
agency DeepLocal, 
making ‘wild and 
whimsical’ robots. 


tabb.me 


Warning! 
Hot mess! 


Gooey butter is messy 
stuff. Be prepared for 
your kitchen, as well 
as your grilled cheese 
sandwich, to be buttered 
all over! 


aking a splash with your final-year 
M university project can be the ideal way to 
gain the attention of potential employers 

and land yourself your dream job. Appealing to your 
lecturers’ and classmates?’ stomachs is also a pretty 
effective way of getting them onside. Hearing from 
Taylor Tabb about the robot project he and friends 
Mitchell Riek and Evan Hill cooked up for their 
mechanical engineering degree, it’s little surprise 
to learn that having graduated in the summer of 
2019, he’s already embarked on a fantastic-sounding 
Raspberry Pi-focused career. 

“Cheeseborg was born out of our need to concept, 
design, and build a final prototype of a project in our 
senior engineering design class,” says Taylor. “As 
hungry college students awake at hours that it’s often 
hard to find food, we knew this was our calling - not 
just for us, but for grilled cheese eaters everywhere.” 

Cheeseborg is a dedicated, hands-free grilled 
cheese making robot that will satisfy cheese cravings 
at all hours. The Google Assistant SDK and ATY Voice 
Kit provide voice activation. Both “work fantastically 
with Raspberry Pi 3 Model B+,” says Taylor. Their 


Cheeseborg requires you 
to say please when you 
ask for a grilled cheese! 
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A vacuum picks up La Ñ People usually love Cheeseborg's 


the slice of toast to be — hyper-mechanical motions paired 
‘buttered’ before toasting ema, with the whimsy of grilled cheese 


Quick FACTS 


> His first Raspberry 
Pi project was a 
‘not great’ radio 
J telescope 


v 


Taylor now works 
with Raspberry Pi 
almost daily 


His business card 
says he's ‘sweeter 
than Raspberry Pi! 


Vv 
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Taylor thinks 
there's a whole 
world of culinary 
robots to come 


Cheeseborg’s acrylic 
SS body is hidden in a laser- 
etched wood enclosure 


Raspbian and Raspberry Pi allowed 
Cheeseborg's makers to explore 
dozens of versions of its interface 


v 


He recently made 
a not-so-edible 
bubble maker: 


magpi.cc/ 
loTBubbleMaker 


A The Cheeseborg even 
features a mini chute for 
delivering the sandwich 


d We do love a grilled cheese 
sandwich and this one looks 
pretty tasty 
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to take shape in the 
Carnegie Mellon 
University makerspace 


m A dedicated, hands-free grilled cheese 


making robot 


that will satisfy cheese 


cravings at all hours Ø 
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customised build of Google Assistant, sourced from 
the AIY Kit and Google Cloud SDK, allowed them 
to add some personality: you can ask about the 
weather while awaiting your sandwich. 

Raspberry Pi also triggers its assembly, while 
motor control circuits and motion are operated by 
Arduino Mega. Taylor reveals, “We wrote our own 
code, but also used open-source Arduino libraries, 
dictating timings and the motions for each step. 

Carnegie Mellon’s Department of Mechanical 
Engineering’s makerspace provided hardware 
commonly used in 3D printer kits, such as stepper 
motors and linear motion carriages. However, 


» 


the acrylic parts were designed and laser-cut 
by Mitchell, Evan, and Taylor. Impressively, 
the project cost just $200 to build, and took 
approximately eight weeks to complete. 


Taste test 
The team undertook three weeks of customer 
research to identify grilled cheese preferences. 
“There was a lot of going back and forth between 
our build, CAD software, and laser cutter, adjusting 
parts as we learned more about the mechanics of 
bread and cheese,” recalls Taylor. They spent days 
just tuning the grilling time to get the gooeyness 
and crispiness just right, while experiments in 
applying the butter resulted in a thoroughly dairy- 
spattered makerspace. 

Eventually, they went with a spray ‘butter’. 
“We aimed at the cooking plates and activated 
just before the bread was moved to be cooked, 
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Making your own 
grilled cheese robot 


This is the ideal project with which to use 
Google Assistant in Google's Raspberry Pi 
AIY Voice Kit, and the Google Cloud SDK for voice 
activation. Experiment with phrases to initiate the 
snack-assembly process. 


A Cheeseborg's makers 
earned even more goodwill 
from their classmates when 
they brought it along to 
their design expo 


4 Taylor, Mitchell, and Evan at 
5am, just after Cheeseborg 
was finally finished 


Raspberry Pi now hands over to Arduino. 
Use Arduino Mega to control the robot that 
assembles the grilled cheese sandwich once 
Raspberry Pi instructs it. Open-source Arduino 
libraries are invaluable here. 


thus buttering both sides [not to say the rest of 
Cheeseborg]. In the end, we found if we just spray 
the grill plates every five [sandwiches] or so, it still 
is enough to make a crispy, gooey grilled cheese! 

“As with all good projects, we had no idea if it 
was going to work until 4am the morning before it 
was due, when Cheeseborg popped out its first fully 
hands-free grilled cheese sandwich.” 


Making your own grilled cheese robot 
Interest levels online have been such that Taylor 
and his colleagues may consider offering a kit 
version. While he cautions that there’s a huge 
amount of fine-tuning involved, he says, “If 
anyone out there is building a grilled cheese robot, 
we’re more than happy to offer any insights.” 
Contact him at tabb.me/grilledcheese. L) 


03 Use tongs or suction to pick up slices of bread 

and add a chute for the snack’s delivery. 
However, positioning bread to be buttered and 
adding cheese takes patience. 
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CutieP1 


Want to liberate your projects from the desktop? This 
all-in-one Raspberry Pi tablet may provide the answer. 
Phil King investigates 


A digital nomad 
wannabe from 
Taiwan, currently 
living in Tokyo 
and working as a 
principal software 
engineer at The 
Qt Company. He's 
leading a team 

of open-source 
enthusiasts to 
make the CutiePi 
tablet happen. 


cutiepi.io 
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Linux-based portable device, a group of 

enthusiasts set out to create one and the 
CutiePi tablet was born. Based around a Raspberry 
Pi Compute Module 3+ Lite and custom carrier 
board, it features an 8-inch touchscreen, typical 
tablet features, and everything you need to make 
your Raspberry Pi projects portable. 

“We tried to make the CutiePi tablet on par with 
normal tablets,” says project lead Penk Chan. 
“You'll find a gyro, a microcontroller for battery 
and button monitoring, WiFi/Bluetooth, anda 
speaker. We also kept the camera connector and 
made the remaining GPIO pins available, keeping it 
hacking friendly.” This will enable it to be used as a 
launchpad for users’ portable Raspberry Pi projects. 

Making a portable device isn’t easy, though. “It’s 
not just about the Li-Po battery nor the DC-DC 
step-up converter,” says Penk. “Those features 
that we take for granted in consumer electronics, 
like using the device while it’s charging, reading 
remaining battery level, or simply detecting a 
power cable plug-in, are very hard to get right with 
modules and kits, let alone having a user interface 
that works. To top it all off, you need a case that 
houses all the hardware parts and cables.” 


L aving long dreamt of owning a usable 


dering toward, atc bow peopse m meng 
The Greatest Motirabon Is Centritrating to Success |3 


IN BRIEF 


K The crestest toan achievements are 
driven by all inam members understanding 
the ultimate goal and being free to 

cmanyely peeblem save in oret to get 


A You'll be able to 
rotate the screen 
to portrait mode, 
for instance to use 
it as an e-reader 


their own custom-designed carrier board. “Using 
the Compute Module allowed us to make the device 
a lot thinner, explore other form factors other than 
the regular Raspberry Pi 3’s, and probably most 
important of all, it allowed us to mass-produce the 
CutiePi tablet,” explains Penk. 

Taking around three months to develop, the 
CutiePi carrier board is based on the reference 
designs made freely available by Raspberry Pi, and 
the team have open-sourced their now OSHWA- 
certified hardware: magpi.cc/CutiePiBoard. “At 
the heart of this project is our love for open- 
source, and CutiePi is our expression of that 
affection,” says Penk. “All designs are available 
under open-source licence, and anyone who 
wants to produce it, or even build on it to make 
their next portable project, can freely do so. In 
fact, we advocate it.” 


m Anyone who wants to produce it, or even build on it to 
make their next portable project, can freely do so Ø 


Custom carrier 

The first CutiePi prototype was a cardboard box 
which housed an off-the-shelf HDMI display, a 
Raspberry Pi 3, and a power bank. For the second 
one, they stripped everything from the Raspberry 
Pi 3 board and soldered flex cables to replace the 
bulky HDMI connector, with the electronics now 
housed by a 3D-printed case. 

While most hobby projects would have stopped 
there, the team went on to create a third prototype, 
based on a Compute Module 3+ Lite connected to 


Multi-touch display 

The CutiePi tablet features a 1280800 MIPI-DSI 
display, with a five-point capacitive multi-touch 
panel. The user interface is built on top of Raspbian, 
and you can access the standard Raspberry Pi 
Desktop via a toggle switch. “When you toggle on 
over to our made-from-scratch, touch-friendly UI, 
you will have access to the CutiePi shell, including 
a WiFi settings manager, a Chromium-based 

web browser that supports all the common touch 
gestures, an on-screen keyboard with multiple 


A Chromium-based web 
browser supports all the 
common touch gestures 


3D-printable files for the 
tablet case will be made 
freely available 


languages layout, and a terminal emulator, as part 
of our software version 1.0 release.” 

Penk tells us that in the future it will be possible 
to support native Raspberry Pi apps in the CutiePi 


shell through use of XWayland, 


a fully-fledged 


X server implementation for the Qt Wayland 


Compositor being used for the d 

It all sounds very promising a 
hardware parts near finalised, t 
focusing on the design for the fi 


isplay. 

nd, with the 

he team are 

nal version of the 


tablet’s enclosure. They have decided to crowdfund 
the project in order to mass-produce CutiePi, so 


keep an eye on those crowdfund 


ing sites for it. LU) 


Qt Virtual Keyboard is 
used to generate the 
8-inch touchscreen’s 
keyboard 


The OS is based on 
Raspbian, so you'll be able 
to run standard applications 
and access a terminal to 
enter commands 


Y The CutiePi carrier board 
for the Compute Module 


3+ Lite is crammed 
with functionality 


Amplifier + 


WiFi/BT += 


STM32MCU +-- $ 


Gyroscope < 


SO-DIMM socket 
for CM3/CM3+ T 


power management 4 * 


MägPi 


CutiePi gets its 
name from the Qt 
framework used 


The carrier board 
features a sleep/ 
wake button 


The CutiePi 
prototype uses a 
5000 mAh 

LiPo battery 


A 3D-printable case 

design file will be 

released very soon 
> A Raspbian image 


will also be made 
available for testing 


sleep/wake 
button 


>K micro HDMI 


==-==> USB-C charging 


“| ===> USB type-A 


=-=- GPIO pins 


=*=- microSD card slot 
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Bit Time — Rotary 
Dial Phone Project 


A unigue project in Essex explores how all ages engage with the tools that enable 
us to communicate, including using two upcycled retro phones. Nicola King dials in 


a wider initiative called Bit Time — a 

project that has been running in Basildon 
over recent months. Lead artist Laura Trevail 
explains, “Bit Time is an intergenerational project, 
combining the skills and knowledge of the very 
young with those of our elders. As artists and 
facilitators, we’ve been bringing together these 
ideas and possibilities into playable works that in 
themselves keep that momentum going. These 
are projects about communication technology, 
but they are also communication technologies in 
themselves. By interacting with the art, you are 
interacting with each other.” 


T he Rotary Dial Phone project is part of 


Dave Norton 
and Laura 


Trevail Cold calling 


So, the retro phones... where do they fit into this 
story? Phone project artist Dave Norton says, “The 


Dave is a Digital 
Artist and Drama 
Practitioner, and 
his work ranges Py 
rom large- Triggered bya 


scale interactive N motion detector, Se 
installations to live each phone ga 
heatre performed Pi 

in a virtual world. starts ringing =- 
Laura is an Artist when someone 

and Context 7 walks past it 


Strategist with an 
outdoor theatre and 
ive-art background. 


magpi.cc/bittime 


The answer phone plays a 
random response recorded 


from the question phone 
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inspiration for the question/answer phones came 
from a desire to build a device that lets you share a 
message with someone you’ll never meet. A digital 
time capsule of anonymous thoughts, advice, 
stories, and memories that could be listened to 

by anyone. You have no idea who might hear your 
message and how it could affect them.” 

He explains how the system works: “You walk 
past a phone and it starts ringing, you pick it up 
and the operator asks you to answer a question, 
e.g. ‘what was your first phone? , ‘what will a 
phone of the future look like?” A ‘recording’ light 
comes on and you leave your message and hang 
up. Later on, you see another phone that also rings 
as you walk past; you pick it up and it plays backa 
random message left by someone else.” 

A motion detector identifies when someone 
walks past, while a push-button detects when the 


The question phone 
plays a random question 
to whoever picks up the 
handset and records 
their response 


Testing a phone before installation. 
Due to power constraints; the 
phone bell and recording sign have 
to be disconnected during bootup 


receiver is lifted. The phone’s mic and speaker 
are hooked up to a Raspberry Pi, which chooses 
a random audio file question to play. “The mic 
starts recording the user’s message for 15 seconds, 
or until they hang up, then the whole process 
restarts. The answer phone works in a similar way, 
but only chooses random audio files to play back.” 
Since the installation needed to work in any 
kind of location, it couldn’t rely on WiFi to transfer 
audio files between the phones, particularly as the 
audio files needed to be checked manually before 
they could be shared with the public. “I ended up 
having to code a ‘syncing’ mode, which is activated 
when a USB drive is inserted into Raspberry Pi, 
which automatically transfers all the audio files to 
the drive,” reveals Dave. 


D Some people just hang 
up straight away, some 
people audibly freak out @ 


You talkin’ to me? 

The Bit Time project, including the rotary dial 
phones, ultimately became an exhibition which 
toured Basildon in the summer of 2019. Dave says, 
“There’s something really unburdening about 
being anonymous, and something really pleasing 
about being given an open platform to speak your 


U 


H 


PROJECT SHOWCA 


A Dave says it was easy to snip the wires from each phone's speaker, 


mic, and hang-up button and connect them to Raspberry Pi 


mind. I loved the idea that the installation starts as 
a blank slate and, as it travels to different events 
and locations, it collects a mixture of stories and 
thoughts and shares them with anyone who cares to 
listen, something akin to a travelling storyteller.” 

He says the phones elicited a variety of 
reactions. “Some people just hang up straight 
away, some people audibly freak out that they’re 
actually being recorded, some yell bizarre phrases, 
but most people genuinely answer the question. 
No two answers have been similar and it makes for 
some really interesting listening... We’ve ended up 
with hundreds of varied audio responses — it would 
be lovely to build some sort of audio installation 
using all the clips.” C) 


Quick FACTS 


> The phones project 
took around three 
weeks to complete 


v 


Basildon Library 
Creator Space 
provided a location 
to construct the Bit 
Time artwork 


v 


A 5V solenoid is 
used to ring each 
phone's bell 


v 


Dave programmed 
each Raspberry Pi 
using Python 


v 


He suggests the 
phones could be 
used in the foyer 
of a venue after 
an event, to glean 
honest views 
from attendees 
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OOLS YOU CAN US 
D DIGITAL TOOLS TO IMPROVE 


K VANSTONE 


THE RANGE OF T 
E 50 PHYSICAL AN 


YOUR MAKING SKILLS. BY MAR 


hether you are new to making with 

Raspberry Pi or have been at it for years, 

there are always new tools and techniques 
to be learned. For the new arrival to the making 
community, this list will be a great resource to 
introduce you to tools that you may not have heard of 


Warning! c 
before, and a short cut to get to the bits of software 
Some of these tools use that work best for Raspberry Pi projects. If you’ve been 
mains electricity and K N E 
heated parts. Always follow doing this for a while, you may want to count how 

Sohne aula E many of these tools are already in your makerspace. If 
and never leave heated i 

elements unattended. you get to 50, you probably need a bigger makerspace. 
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The 3D printer is a fairly recent 

addition to the maker scene. To be 

able to print something solid a few 
years ago was like science fiction, but now 
it’s a reality. Printers come in many sizes and 
prices, so you can match your printer to your 
budget and requirements. There are several 
choices for filament too, such as PLA (a good 
beginner’s choice) or ABS and many other 
more specialised types. If you have the time 
and patience, you can get a small unassembled 
one for less than £100, but for better quality 
and less frustration) you may want to spend 
a bit more. 


Mä 1s 


BREADBOARD 


Breadboards are 
solderless circuit 
boards and allow for 
fast prototyping of projects. The 
boards come in several sizes 
and consist of a matrix of small 
connector holes into which 
components and jumper wires 
can be inserted to make circuits. 


LEDs (light-emitting 

diodes) are a bit like very 

small and efficient light 
bulbs. They glow when current is 
passed through them, but they 
need to be connected correctly. 
Because they are diodes, the 
current only flows one way, unlike 
in conventional light bulbs. 


[N 


Resistors are used in 

electrical circuits to reduce 

current flow. They are 
used for many reasons, including 


They can be a fixed value, with 
stripes to indicate the resistance; 
or variable, with a slider or dial to 
change the resistance. 


There are several 
code editors 

for Raspberry 

Pi. IDLE used to be 

the standard Python 
editor in Raspbian, but 
now you might want to 


changing the brightness of an LED. 


give Thonny or Geany a go. If you are feeling 
adventurous, you could try installing PyCharm. 


There are many types of electronic 
sensors. You may want to detect light 
or vibration, 

sound, or heat. There 

are sensors for all of 

these and many more. 

Sensors allow us to 

capture data about the 

world around us. 
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Ø balenaEtcher 


For holding bits of your build together until it’s 
stuck or you need to change it. 


Connect one component to another without 
soldering, tape, or breadboard. 


Pinches connectors onto wire, fixing it to the 
connector. Can also can cut/strip wires. 


You’re going to need several different 
screwdrivers of different sizes/types. 


Stanley knives are good for most work, but you 
might also want something lighter. 


Tweezers can get you out of a fix when that little 
screw disappears. 


Sometimes there is no substitute, but it’s not 
suitable for the young ’uns. 


Most of the time a cordless is best. 


Hacksaws for metal/plastic parts, jigsaw/ 


circular for big builds, mitre saws for angles. If you are making any sort of moving robot 


you’re probably going to need wheels or 
gears. Some kits come with them, such as the 
CamJam EduKit 3. You can buy them separately or even 
A good set of long-nose/snipe-nose pliers 3D-print them. 
should be on hand at all times. 
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Add extra storage to your Raspberry 
Pi with a USB thumb drive. You can 
store more files than the microSD 

card, and you can transfer 


files from another 
computer to your 
Raspberry Pi. 


A 


6 
RD TRIMMER 


Laser cutters and 
engravers fire a 


Make sure you have multiple microSD 
cards. An 8GB microSD card can be 
used to install Raspbian and other 
operating systems. It’s a good idea to 
have your regular microSD card 
and at least one other card 


e for testing out projects. 


laser at a material 


to either cut through it or to leave a mark or indent on 
the surface, depending on the intensity of the laser. 
Very effective for cutting irregular wooden shapes. 


These machines are very 
much like plotters, but have 
a knife instead of a pen. They can 
cut very intricate designs out of paper and 
fairly thick card. They can be a bit temperamental 
and often need a sticky carrier sheet to work well. 


MägPi 


When making projects, you 
quickly rack up additional 

kit - not to mention cables, 
components, and Raspberry Pi 
boards. Keep everything in one 
place by adding a storage box 
to your shopping list. 
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PLASTIC SHEET 


Acrylic plastic sheeting is very 

tough and can be cut using a 

saw or CNC router, whereas 
thermoplastic sheets are malleable when 
heated with a heat gun. Once cool again, 
thermoplastic retains its new shape. 


This material is usually 

supplied as granules 

or beads. You can heat 
them up in boiling water and 
they will clump together ina 
mass. While still warm, you can 
mould the plastic before it sets 
hard in ten minutes or so. 


magpi.cc/alufoil 


GPIO (general-purpose input/output) For some projects, you may want Jumper wires connect Raspberry Pi 
pins are the interface between to connect a HAT or pHAT to your GPIO pins to electronic components. 
your Raspberry Pi and electronic Raspberry Pi, but not place it right Use them with a breadboard to 
components. Until you learn which on top of the board. In this case, prototype your circuit, or solder them 
pin is which, you’ll need a guide. a female-to-male 40-way ribbon directly to components. Be sure to get 
There are several GPIO rulers and connector enables you to extend the a variety of different colours to make 
guides available to make life easier. reach of the GPIO pins. your project easier to understand. 
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This equipment enables you to clean melted 
solder from components on a printed circuit 
board, allowing their removal or replacement. 


A handy stand to place a soldering iron while it 


is still plugged in and hot. The sponge should be 


wet to clean the end of the iron. 


An absolute necessity for soldering or 
desoldering components onto printed circuit 
boards. For detailed work, an iron with a 
pointed end is best. 


Usually has a solid, heavy base with jointed 
arms with clips or holders at the end, and a 
magnifying glass for working on 

small components. 


4 
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You need to be able 
to measure current, 
resistance, and voltage in 
your circuits. Digital multimeters 
can cost as little as £10. 


NUTS, BOLTS & SCREWS 


Having a good range of sizes and shapes 
of nuts, bolts, and screws is absolutely 

necessary for making anything that you 
are not going to glue. Keep a jar full of spares. 


You may want 
to visualise your 


build before starting, and there are 
many 3D software packages to help you for 
free, like Blender; or with free trial versions, 
like SketchUp. 


When you have completed your 
project, you may want to document 
how you did 

it. Fritzing is a great 

program for laying out 

circuit diagrams. 


One of the most important tools you 
will use for just about any maker 
project is reference material. Your 

Raspberry Pi may have come with some tips 

and hints about making, and many kits have 

worksheets and Frequently Asked Questions 
sections with them. Also, make best use 

of the online resources that detail other : E 

people’s experiences: like Stack Overflow vA ESH 

(stackoverflow.com) for information x i Raspberry Pi 4 

about any technical subject; blogs such as 

modmypi.com, recantha.co.uk, and 
blog.pimoroni.com; and of course the 

Raspberry Pi site (rpf.io) and magazines. If 

you’re stuck getting something to work, it’s 

likely someone else has had the same problem! 
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Retro Gaming with Raspberry Pi shows you 
how to set up a Raspberry Pi to play classic games. 
Build your own portable console, full-size arcade 
cabinet, and pinball machine with our step-by-step 
guides. And learn how to program your own games, 
using Python and Pygame Zero. 


= Set up your Raspberry 
Pi for retro gaming 

= Emulate classic 
computers and consoles 

= Learn to program 
retro-style games 

= Build a portable 
console, arcade cabinet, 
and pinball machine 


BUY ONLINE: magpi.ce/store 
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Danny Staple 


Danny makes 
robots with his kids 
as Orionrobots 

on YouTube, and 

is the author of 
Learn Robotics 
Programming. 


orionrobots.co.uk 


| You'll Need 


> Lunchbox Robot 
with Camera 
magpi.cc/88 


> A neutral floor area 
> Good lighting 


> One of: 
Brightly coloured 
toy-boxes; 
300 gsm brightly 
coloured card 


Add navigation to 
your low-cost robot 


Make a robot that sees with computer vision! Take your 


first steps in OpenCV on a moving robot 


Raspberry Pi-powered lunchbox robot. They 

got a photo from the robot’s-eye view of the 
world. Now a robot builder gets to take this much 
further and make the robot use this camera to 
make decisions about the world. 

This tutorial shows how to make an 
environment for testing computer vision. It 
demonstrates using OpenCV to condition images, 
to remove noise and simplify them. Then readers 
see how to extract data or check the content of an 
image and use this to make a robot turn. 


| n the last article, readers added a camera to a 


A test course 
For trying out behaviours, robot builders 
make test courses. The goal is to create an 
environment with only the specific features to try 
out the robot. 
Find a floor area in a neutral colour. Somewhere 
white or grey without patterns or colour. 
Make walls with flat colours like red, blue, green, 
and yellow. Toy-boxes or coloured card work for 


A Figure 1 The HSV colour space 


38 | magpicc | Add navigation your low-cost robot 


this. Use white or neutral background walls. 
Cameras take better pictures with bright and 
consistent lighting. In good lighting, colours are 
clearer, making processing easier. 

Good options are daylight or bright white indoor 
lighting. Avoid tinted or patchy lighting. 


Installation 
This step may take some time. Pluga 
mains-powered USB adapter into the robot’s 
Raspberry Pi before proceeding. 
Before installing the packages, make sure 
Raspbian is up to date with: 


sudo apt update -allow-releaseinfo-change 


There are some system packages needed for 
running the Python libraries. 


sudo apt install libcairo-gobject2 libwebp6 
libilmbase23 libgdk-pixbuf2.0-@ libjasper1 
libpango-1.0-@ libavcodec58 libavutil56 
libcairo2 libswscale5 libatk1.0-@ libgtk-3-0 
libtiff5 libpangocairo-1.0-0 libavformat58 
libopenexr23 libgfortran5 libatlas3-base 


Finally, install the Python packages needed for 
OpenCV, NumPy, and picamera: 


sudo pip3 install opencv-python-headless 
numpy imutils picamera[array] 


Set up the camera 
The function setup_camera in the file 
find_contours.py gets the camera ready. 


The colour of these walls 
will be used to choose 
which way to turn 


m Our robot's camera 
is upside down, so 
the rotation is set to 
180 degrees Ø 


For quick processing time, and to simplify the 
image, line 11 sets a camera resolution of 128128. 
Our robot’s camera is upside down, so the rotation 
is set to 180 degrees. Using camera features saves 
processing on Raspberry Pi. 

Line 14 creates capture_buffer, space to store 
image data from the camera. Lines 15 and 16 start 
the camera with two seconds of warm-up time. 

With the robot in front of a coloured wall, run 
the following commands: 


export LD_PRELOAD=/usr/1lib/arm-1linux- 
gnueabihf/libatomic.so.1 
python3 find_contours.py 


This code send the camera’s captured image to the 
file original.png. 
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Zeen. 


The robot uses the 


camera to navigate 
this test area 


| Figure 2 2 


ag UL 


convert to | eied | find find get center | match with 
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A Figure 2 It takes 
a few steps for 
visual processing, 
with a number of 
transformations. A 
pipeline is a useful 
way to visualise this 


A little colour theory 
Computers store colours as RGB or BGR, for 
red, green, and blue pixels. 

In find_contours.py, on line 21, we convert the 
image from BGR to the HSV colour system, which is 
suitable for this image processing. 

Figure 1 shows how HSV works. Saturation 
measures how vivid or intense the colour is, froma 
low value being white or grey, to a full value being 
vivid. Hue indicates the colour - red, orange, blue, 
green, yellow, etc. 

Transforming the image into HSV - Hue, 
Saturation, and Value - lets the robot pick out 
colour intensity (saturation) and then find its 
tint (hue), while mostly ignoring the colour 
brightness (value). 
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> Language: Python 3 


i DOWNLOAD 
find_contours.py Eug 


© magpi.cc/robotCv1 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 


024. 
025. 


026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 
035. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 


import time 

import imutils 

import numpy as np 

import cv2 

from picamera.array import PiRGBArray 
from picamera import PiCamera 


def 


def 


setup_camera(): 

camera = PiCamera() 
camera.resolution = (128, 128) 
camera.rotation = 180 


capture_buffer = PiRGBArray(camera, size=(128, 128)) 
camera. start_preview() 

time.sleep(2) 

return camera, capture_buffer 


get_saturated_contours (image): 

hsv = cv2.cvtColor(image, cv2.COLOR_BGR2HSV) 

# Mask for vivid colours 

masked = cv2.inRange(hsv, np.array([@, 140, 30]), 


np.array([255, 255, 255])) 


cv2. 


if _name_ == '_ main_': 


# Find Contours 

cnts = cv2.findContours(masked.copy(), cv2.RETR_EXTERNAL, 
CHAIN_APPROX_SIMPLE) 

contours = imutils.grab_contours(cnts) 

contours = sorted(contours, key=cv2.contourArea, reverse=True) 


colour = [@, ©, ol 
if len(contours) > @: 
# Find the center of the contour 
m = cv2.moments(contours[@]) 
if m["mee"] > ð: 
cx = int(m["m10"] / m["mee"]) 
cy = int(m["me1"] / m["mee"]) 
colour = hsv[cy, cx] 
return masked, contours, colour 


camera, Capture butter = setup Camera) 

camera. capture(capture_buffer, format="bgr") 

image = capture_buffer.array 

masked, contours, found_colour = get_saturated_contours(image) 
cv2.imwrite('original.png', image) 
cv2.imwrite('masked.png', masked) 

cv2.drawContours(image, contours[:1], -1, (©, 255, ©), 1) 
cv2.imwrite('with_contours.png', image) 
print(found_colour) 
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A Figure 3 Example of a masked or thresholded image. 
Pixels are only on (white) or off (black) 


Image processing pipelines 

The code processes images from the camera 
through a series of transformations to find the 
colour of a wall. Each transform is a small step; for 
example, finding all the pixels that match a criteria 
or making an outline of an area. 

Later stages use the transformed output of 
earlier ones. The outputs are joined to other inputs, 
forming a pipeline. 

A diagram like Figure 2 (previous page) shows 
where data flows from one process to another, 
making it easier to understand what is going on. 
Use images from real outputs, boxes for stages, and 
lines to show the flow of data. 


Thresholding or masking 

Thresholding tests if every pixel has values 
within a range. Line 22 of find_contours.py uses 
cv2.inRange for this. It makes a new binary image, 
storing True if the pixel has values between the 
lower limits and the upper limits. 


Figure 4 


A Figure 4 This is the original image, after a contour has been 
found from the threshold image and drawn back on it 


The find_contours.py range allows all hue 
values while filtering for saturation values over 
140, for only vivid colours and the value component 
to values brighter than 30. 

The output file masked.png shows the output, 
with coloured walls in white (see Figure 3 for 
an example). 

The S and V values of the lower bound on line 22 
can be adjusted up if too much area is matching, or 
down if too little is. 


m OpenCV can inspect a 
black and white image and 
find outlines for different 
areas. It calls these 
outlines contours @ 


07 Finding contours 
OpenCV can inspect a black and white image 
and find outlines for different areas. It calls these 
outlines contours. 

In find_contours.py, lines 28 and 29 obtaina 
list of contours. Each contour is a list of points 
describing the outline. 

On line 30, the contours are sorted by area. By 
finding the first contour in this list (the biggest), 
the code has likely found the most significant 
coloured area. 

On line 48, the contour is drawn out to a debug 
image with_contours.png. Run the code and 
download the image to see how the contours look 
(see Figure 4 for an example). 
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A Figure 5 A hue colour wheel is handy for looking up colours. 
The figures under the degrees show the OpenCV values 
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Finding the colour ‘ 
For this code to choose by colour, it needs Top TI p a 
the hue from the middle of the contour. It takes 
this colour from the original picture. 
The robot uses OpenCV moments for finding the 
middle of a contour. 
By dividing the sum of X coordinates (m1@) by 
their count (mee), the code obtains the average X, 
their centre. The code also obtains the average 
and centre of the Y coordinates (me1 divided by 
mee). The middle of the contour comes from 
combining these. 
The code on line 36 of find_contours.py extracts 
the colour from the hsv output at the middle of 
the contour. 


Lighting matters 


Lighting should be 
neutral in colour, 
bright and diffused. 
Spotlights, low 
light, and coloured 
lights cause 
problems with 
visual processing. 


Using the pipeline in a robot 

The get_saturated_colours function is 
imported from find_contours.py, enabling this 
code to reuse the pipeline from already tested code. 


DOWNLOAD 
camerd_ndav.py THE FULL CODE: 


> Language: Python 3 © magpi.cc/robotCv2 


001. import gpiozero 

002. from camera_setup import setup_camera 

003. from find_contours import get_saturated_contours 

004. 

005. robot = gpiozero.Robot(left=(27, 17), right=(24, 23)) 
006. camera, Capture butter = setup_camera() 

007. 

008. for raw in camera.capture_continuous(capture_ 

009. buffer, format="bgr"): 


010. image = raw.array 

011. masked, contours, found_colour = get_saturated_ 
012. contours(image) 

013. print(f"Colour {found_colour}, h value: {found_ 
014. colour[@]}") 

015. if 5 < found_colour[@] < 49: 

016. print("yellow") 

017. robot.left() 

018. elif 10@ < found_colour < 135: 

019. print("blue") 

020. robot.right() 

021. else: 

022. robot.forward() 

023. capture_buffer.truncate(@) 
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small 


E 


canny 


A continuous stream of images is needed to 
use the pipeline to drive the robot. Line 8 of 
camera_nav.py creates this stream; line 9 extracts 
the data. Line 8 sets up the main loop as a for loop 
that runs forever with a new image each time. 

The main loop puts the image through the 
pipeline and uses the output to determine if 
the robot turns right, left, or goes forward. The 
camera’s image rate sets the timing. 
The colour returned by get_saturated_colours 
is HSV. 


Matching the colour 
The camera_nav.py code uses the hue 
component from get_saturated_colours. 

OpenCV stores a hue value as degrees divided by 
2 to fit into 8 bits (up to 255). Figure 5 (previous 
page) shows a colour wheel with hue values in 
degrees and OpenCV values. 

The code in camera_nav.py matches a yellow 
range on line 12, and a blue range on line 15, 
printing the matched colour and turning the robot. 

By setting up a series of walls of different 
colours, the robot can now navigate by wall 
colours. Expect to change these ranges for different 
test areas. 

Ensure the robot is on battery power and in the 
test course before running this. 


mask 


hsv 


horizon 28.0° 


= 


A Extending the pipeline 
leads to detecting edges 
and finding the angle of 
the horizon. This could 
be used to line a robot 
up with a wall 
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m A continuous stream 
of images is needed to 
use the pipeline to drive 
the robot @ 


Improving robot vision 

The find_contours.py code is a simple 
demonstration of computer vision. It’s also easy to 
confuse it. Finding the image under the contour and 
averaging the colour would make it more stable. 

The code could be combined with distance 
sensors, so only walls close enough were detected. 
Encoders or an inertial measurement unit (IMU) 
could be added to make a precise turn. 

Advanced techniques like Canny Edge Detection 
with HoughLines could pick out the horizon, 
determining the angle and distance, so the robot 
could line up with a wall. OpenCV can do face 
detection and even has machine learning and 
neural network modules. 


Further reading 

Robot vision is a significant area of study 
in robotics, and this article has barely scratched 
the surface. It’s one of the more rewarding 
and exciting spaces of robotics, worthy of 
further reading. 

The PylmageSearch site (pyimagesearch.com) 
is a superb resource to learn more about computer 
vision and dig further into detecting different 
attributes from an image. 

Your article author’s book, Learn Robotics 
Programming, has a section on computer vision, 
building face- and object-following behaviours, 
and casting the camera and pipeline stages toa 
mobile phone browser to view in real time. I 


TopTip & 


Reduce background clutter 


A cluttered background causes the robot to detect 
random things. Neutral backgrounds without ‘noise’ 
make this easier to test. 


Strato Pi is a line of servers based on Raspberry Pi for the development of distributed/decentralized 
field control solutions. It is ideally suited for industrial applications where extreme reliability, 
ruggedness, and compliance with technical and safety directives are required. 


lono Pi is an extremely versatile I/O module that combines several digital and analog input lines, 
power relay outputs, and support for standard interfaces, typical of a modern PLC, with the 
powerful computing core of the Raspberry Pi. 


On the trail of the new Raspberry Pi 4, we upgraded our products to fit its mew design and 
capabilities. The re-engineered power-supply stage withstands the current demand of Raspberry Pi 
4, including that of external devices powered via USB or through the auxiliary power supply output. 
The DIN-rail case now fits the new USB and Ethernet ports layout, as well as the new micro HDMI 
ports and USB-C power supply. 


Sc 


The new Strato Pi and lono Pi are available on our website with pre-assembled Raspberry Pi 3 B+ or 
Raspberry Pi 4 2GB and 4GB. 


Find out all the details on our website www.sferalabs.cc! 
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Smart classroom 
assistant 


Create Al in Scratch using Machine Learning for Kids, 
and find out how machine learning really works! 


n this project, you will use the Create a project 
| Machine Learning for Kids tool Click on Projects in the menu bar at the top, 
(machinelearningforkids.co.uk) to make a and then click on the ‘+ Add a new project’ button. 
Dale smart virtual classroom assistant that reacts to Name your project ‘smart classroom’ and set it to 
Lane what you say to it. You’ ll be able to control the learn to recognise text, then click on Create. You 
classroom’s virtual devices by typing in commands! should now see ‘smart classroom’ in the projects 
Dale works for First, you’ll create an assistant that uses a list list; click on this project. 
IBM and created l 
the: Machine Learning of rules for understanding commands, and you’ll 
for Kids web- learn why that approach isn’t very good. 
based tool. Next, you will teach the assistant to recognise 
magpi.cc/MLforkids | commands for different devices by training it Prepare the project 
using examples of each command. Now we need to get a project ready in 
Scratch. Click on Make, click on Scratch 3, then 
click on ‘Scratch by itself’. The page then warns 
you that you haven’t done any machine learning 
Get started yet. Ignore this and click on ‘Scratch by itself’ to 
Head to machinelearningforkids.co.uk launch Scratch. 
in a web browser. You’ll then need to click on ‘Get Finally, click on ‘Project templates’ and then 
Started’, and then click on ‘Try it now’. click on the ‘Smart Classroom’ template. 


You can 
find this project 
and others on the 
Raspberry Pi 
Projects website! 


magpi.cc/projectsonline 
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Add a list of rules 

In this step, you will edit the project to 
include a list of rules to activate and deactivate 
the fan and the lamp. Click the classroom sprite 
to select it, as shown in Figure 1. Click on the Code 
tab and create the script shown in Figure 2. Once 
you’ve done that, click on File and then on ‘Save to 
your computer’, and save the program to a file. 


First tests 

Click on the green flag to test your program, 
and then type in a command and watch the program 
react! The following commands should all work: 


Turn on the lamp 
Turn off the lamp 
Turn on the fan 
Turn off the fan 


Type in anything else and your program does 
nothing! Even if you make a small spelling 
mistake, the program does not react. 


Beyond rules 

You’re telling your virtual classroom 
assistant to react to commands using a simple 
rules-based approach. But if you wanted your 
program to understand commands that are 
phrased differently, you would need to add extra 
“if? blocks. 

The problem with this rules-based approach is 
that you need to exactly predict all the commands 
the smart classroom assistant will understand. 
Listing every possible command would take a very, 
very long time. 
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2 Figure 1 Click on 
‘classroom in the 
Scratch sprites pane 


m The problem with this 
rules-based approach is 
that you need to exactly 
predict all the commands 7 


2 Figure 2 The Scratch 
code for a rules- 
based approach 


when clicked 


forever 


ES Enter your command RK: 


Pla Turn on the fan then 


broadcast turn-fan-on e 


EIST Turn Off the fan then 


broadcast turn-fan-off e 


EISE Turn on the lamp then 


TopTip è 


Machine 
learning 


broadcast turn-lamp-on e 


EH Turn off the lamp then 


You need to tell 
an Al what to 
learn. The more 
you give it to learn 
with, the better it 
will be. 


broadcast turn-lamp-off e 
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> The Smart Classroom 
template is used to 
program the model in 
Scratch 3 


m The more examples 
you give your program, 
the better the program 
should get at recognising 
your commands 


Next, you will try a better approach: teaching the 
computer to recognise commands by itself. 


07 Examples for training 
Close the Scratch window and go back to the 
Training tool, then click on the ‘< Back to project’ 
link. Click on the Train button because you need 
to collect some examples so that you can train the 
computer. To collect different examples, you need 
to create ‘buckets’ to put the examples in. 

To create a bucket, click on ‘+ Add new label’ and 
call the bucket ‘fan on’. Click on ‘+ Add new label’ 
again and create a second bucket called ‘fan off’. 
Create a third and a fourth bucket called ‘lamp on’ 
and ‘lamp off’. 

Click on the ‘Add example’ button in the ‘fan 
on’ bucket, and type in a command asking for the 
fan to be turned on. For example, you could type 
‘Please can you switch on the fan’. For the ‘fan 
off’ bucket, you’ ll need to click ‘Add example’ 
again and then use something like ‘I want the fan 
off now’. Do the same for the ‘lamp on’ and ‘lamp 
off? buckets. 
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More examples for more training 

Continue to add examples until you have at 
least six examples in each bucket. Be imaginative! 
Try to think of lots of different ways to ask each 
command. For example: 


For ‘fan on’, you could complain that you’re too hot. 
For ‘fan off’, you could complain that it’s too breezy. 
For ‘lamp on’, you could complain that you can’t see. 
For ‘lamp off’, you could complain that it’s too bright. 


More is good: the more examples you give your 
program, the better the program should get at 
recognising your commands. 

Use equal numbers: add roughly the same 
number of examples for each command. If you 
have a lot of examples for one command and 
not the others, this can affect the way that the 
program learns to recognise commands. 

Make the examples really different from each 
other: try to come up with lots of different types of 
examples. For instance, make sure that you include 
some long examples and some very short ones. 


Start the training 

You will now train the program using the 
examples, and then test it. The program will learn 
from patterns in the examples you give it, such 
as the choice of words and the way sentences 
are structured. Then, based on the patterns the 
program finds, it can interpret new commands. 

Click on the ‘< Back to project’ link, then click 

on ‘Learn & Test’. Click on the ‘Train new machine 


Recognising text as fan_on, fan_off or 2 other classes 


can you tan ana 
oaa honan a ne? 
ica bem ` een 
un ` oeren 
Peau paea 
Pease mabe dar 
Feat ot ar 


Tum of hang 


e 


A Add as many different and varied example phrases as you can 
for each command 


learning model’ button. If you have enough 
examples, the program should start to learn how to 
recognise commands from these examples. 


Test the training 

Wait for the training to complete. This 
might take a minute or two but once the training 
has completed, a test box appears. Test your 
machine learning model to see what it has learned 
by typing in one of the commands you added to 
a bucket, and then press ENTER. The command 
should be recognised. 

Now type in commands that are not in the 
buckets. If you’re not happy with how the 
computer recognises the commands, go back to 
the previous step and add some more examples. 
Then select the ‘Train new machine learning 
model button again. 

Instead of writing rules for the program, you are 
giving the program examples. The program uses 
the examples to train a machine learning model. 
Because you are supervising the program’s 
training by giving examples, this machine learning 
approach is called supervised learning. 


Use it in Scratch 

Now update your Scratch program to 
include your machine learning model instead of 
the rules-based approach. Click on the ‘< Back 
to project’ link, click on Make, then Scratch 3. 
Here you can read the instructions on the page 
to learn how to use machine learning blocks 
in Scratch. 

Click on Open in Scratch 3, then on File and 
‘Load from your computer’, and select the 
Scratch project you saved earlier. When Scratch 
asks you whether to replace the current project, 
click on OK. 

Click on the Code tab, and update your Scratch 
code (Figure 3) to use your machine learning model 
instead of the rules you first added. The ‘recognise 
text’ block is a new block added by your project. 


when clicked 


forever 


ES) Enter your command eng 
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if MIL] recognise text 
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broadcast turn-lamp-on e 


S| E 
| recognise text | answer > (label 
mm 5 En 


broadcast turn-lamp-off e 


This new block can receive a message and return 
one of the four labels, based on the machine 
learning model you have trained. 


Scratch Al 

Click the green flag to test your new code. 
Test your project by typing a command and 
pressing ENTER on your keyboard. The fan or lamp 
should react to your command. 

Make sure you test that this works even for 
commands that you didn’t include as examples in 
the buckets. 

Save your project as before. Your Scratch smart 
virtual classroom now uses a machine learning 
model instead of a rules-based approach. Using 
machine learning is better than using rules, 
because training a program to recognise commands 
for itself is much quicker than trying to make a list 
of every possible command. 

The more examples you use to train the machine 
learning model, the better your program should get 
at recognising commands. 


If you want to learn about how you can improve 
the model with ‘confidence scores’, head here: 
magpi.cc/smartclassroom [I] 
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lamp_on 


A Figure 3 Revised for 
a machine learning 
approach, the code 
features ‘recognise 
text’ blocks 


TopTip è 


Go further 


Can you get the 
model to tell you 
the weather or 
date? Give it a go! 
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Add internet access 
to a vintage computer 


Missing dial-up? Want to post to a BBS? Build an interface 
to the modern world for your old computer with a Pi232 


Evans 


PJ is a writer, coder, 
and Milton Keynes 
Raspberry Jam 
wrangler. In the 
dial-up days he 
created pages for 
Prestel, which ages 
him greatly. 


@mrpjevans 


| You'll Need 


died out quite yet, but they have gone 

online. There’s only a handful of BBSes 
(bulletin board systems) that you can dial up 
with your old-time modem. If you like the idea 
of accessing an internet-based BBS from your 
Atari ST, Amiga, or BBC Micro, then we can use a 
Raspberry Pi computer to act as a translator. You 
can even use modern services like Twitter! All we 
need to do is get Raspberry Pi talking in one of 
the most popular communications protocols of all 
time: RS232. 


T he bulletin boards of the 1980s haven’t 


A little history 

Every Raspberry Pi computer has a form 
of serial access, which is one of the oldest and 
simplest ways of communicating with computers. 


> MAX3232CPC 
RS232 transceiver 
magpi.cc/MAX3232 


> Small piece 
of stripboard, 
e.g. magpi.cc/ 
stripboard 


> 5 x 100nF 
capacitors 
magpi.cc/100nF 


> 1x 9-pin D-sub 
socket 
magpi.cc/D-sub 


> 1x PL2303-based 
USB/RS232 cable 
(optional) magpi.cc/ 
USB-RS232 


» Jumper leads 
(socket ending) 


These days you’re more likely to use TCP/IP, 
the protocol of the internet, to chat to a remote 
device, but back in the day it was RS232 that 
ruled the communications world. Raspberry Pi 


A Cheat #1: If you don't fancy soldering, you can buy these pre- 
assembled units (for a few pounds) that can connect to the GPIO 
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circuitry features a further simplified version 
often referred to UART (universal asynchronous 
receiver/transmitter) running at 3.3V, but we 
can adapt it to ‘full’ RS232 at 12V so that older 
computers can handle the signal. 


Study and shop 

To ‘downgrade’ a Raspberry Pi to RS232, 
wel need to build a small circuit to act as a 
transceiver so the vintage computer can ‘hear’ 
our virtual modem and the RS232 signals do not 
fry our delicate Raspberry Pi board. Luckily, all 
the heavy lifting for such a job can be done by the 
MAX3232CPC integrated circuit. All you need to 
do is wire it up, add a few capacitors, and you’ ll 
be BBSing in no time. Have a look at the circuit 
diagram (Figure 1, overleaf). We’ve deliberately 
made it larger than it needs to be for simplicity. 
More experienced makers will be able to reduce it 
in size if they wish. 


Soldering the main circuit 

Time to get building. Thankfully, the 
circuit itself is not very complicated, but it’s 
also unforgiving, so make sure all the wiring is 
in the correct place or nothing will work! We 
recommend Starting with the IC socket, then the 
wiring, followed by the capacitors, finishing with 
the headers (optional if you’d like to use jumper 
cables). The result takes the two transmit (TX) and 
receive (RX) lines from the GPIO and feeds them 
into the IC. The MAX3232CPC converts the data 
into RS232 standard and outputs them to the 9-pin 
D connector and vice versa. Check and double- 
check everything. 


Add connectors 

Unless you’re going for a permanent setup 
or looking to make it as low-profile as possible, 
we recommend using DuPont-style jumper cables 
to connect the circuit to your GPIO. Which model 
of Raspberry Pi you use is up to you, but unless 
you have a specific use case in mind, a Raspberry 
Pi Zero W is the perfect choice as it’s small and 
there’s little horsepower required. You will also 
need to solder up the 9-pin D connector. The 
diagram (Figure 1) shows the connector from the 
solder (rear) side. Make sure you wire up correctly 
to pins 2 and 3 and ground it too. 


The circuit itself is not 
very complicated, but it's 
also unforgiving 


Raspberry Pi time 

Your Raspberry Pi Zero W will need a bit 
of configuration before you can get going. Start 
with a fresh microSD card with Raspbian Lite (we 
don’t need a desktop, but feel free to install ‘full’ 
Raspbian if you wish). This is also a great project 
for reusing any old low-capacity microSD cards 
you have, as there’s not much software to install. 
Once booted up, make sure everything is up to 
date by running sudo apt -y update && sudo apt 
-y upgrade. Time to grab a refreshing beverage as 
Raspbian applies all the latest updates. 


Many 1980s and 1990s 
computers came with a 9- or 
25-pin RS232 connector; the 
protocol is still widely used today 


"e 
PN 


> 
e 


By interfacing the Raspberry 
Pi computer UART interface 
to RS232 and then using WiFi, 
we bridge the gap between 
old and new technology 


Prepare your virtual modem 

An ‘out of the box’ Raspbian installation 
isn’t quite ready to go back to the 1980s just yet, so 
we need to do a little further configuration. From 
the command line, run sudo raspi-config to start 
the Raspberry Pi configuration utility. From the 
top of the menu, start by changing your password 


(optional, but recommended); then, under Network 


Options, set your host name (again, optional) and 
configure WiFi. Finally, under Interfacing Options, 
enable SSH and Serial. When asked ‘Would you like 
a login shell’, select ‘Yes’. Now exit the utility and 
shut down the computer (sudo shutdown). 


L 


Cheat #2: The 
simplest solution 

of allis the widely 
available USB-to- 
RS232 cables based 
on the Prolific 
PL2303 chipset 


Top Tip 


Not just 
vintage 


This project works 
well with older 
PCs. Although 
they refer to 

them as COM 
ports, their 9-pin 
connectors are 
really RS232. 
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account 


Many classic BBSes 
are still online, some 
even supporting 
PSTN modems. These 
days, most can be 


fondattheendofan Particles Telnet | Connected: 00:01:59 
Testing time Troubleshooting 
Check your circuit board for any short Having problems? RS232 can be a tricky 
circuits or dry solder joints. Once happy, connect beast as, unless everything is perfect, nothing 
it to the GPIO. There are four connection points: will work at all. The most common issue will 
one for 3.3 V (physical pin 1), ground (pin 9), and be polarity of the TX and RX lines. For things to 
TX/RX (pins 8 and 10 respectively). We recommend work, the RX of the GPIO must be connected via 
getting an RS232/USB cable and testing with the MAX3232CPC to the TX line of the computer 
a modern computer first. Connect the 9-pin and vice versa. Start by checking that your speed 
connectors together and boot your Raspberry is correct and the protocol is set for 8N1. Also try 
Figure 1 Here's the S x x v ` + E ; 
citcuit we're going Pi. Now, using your favourite Terminal emulator reset’ or ‘send break’ in your terminal emulator, 
to build. It's not too program (we like Serial for macOS), try to connect which is sometimes needed to wake up the 
polite sera over RS232. Raspbian’s default settings are connection. Finally, try using a null modem cable 
Een Së 115,200bps (connection speed), eight data bits, no (which crosses over the lines) or swapping the 
double-check parity, one stop bit (aka 8N1). connectors to pins 8 and 10. 
Raspberry PI RS232 Adaptor Raspberry Pi GPIO 


Get online 

If everything is working, you should now 
be greeted with the Raspbian terminal login (you 
might need to press ENTER a couple of times to 
wake it up). You can now log in as normal. If the 
connection is behaving, feel free to try it out ona 
real vintage machine. Some may require adapters 
to connect (1990s home computers favoured 25-pin 
D connectors). You will probably need to reduce the 
speed of the connection, as many older computers 
cannot handle the default 115,200bps. Unless your 
computer is very old, 9,600bps will probably work. 
To set the port to this, enter the following from an 
SSH session: 


9-Pin D (Solder Side) sudo stty -F /dev/serial@ 9600 
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Connect to 0 BBS 

Most BBSes are now online and talk using 
a protocol called Telnet. It is very insecure, 
sending plain text over the internet and has since 
been replaced with SSH (Secure Shell). However, 
many of these services are being run on original 
equipment that has no support for SSH, so Telnet 
it is. The Telnet client software is not installed by 
default, so run sudo apt install telnet. Once 
finished, try connecting to the popular Particles 
BBS (running on an Apple II/e!), by entering: 


telnet particlesbbs.dyndns.org 6400 


Within a few seconds you’ see a welcome 
message. After you’ve had a look around, use 
CTRL+] followed by ‘exit’ to leave Telnet. 


Emulate a classic modem 

If you want a genuine experience, and full 
compatibility with vintage BBS software, it’s easy 
to emulate the classic Hayes AT command-set. To 
install the emulator: 


sudo apt install tcpser 


Before running tcpser, go back into raspi-config, 
select ‘Interfacing Options’, then ‘Serial’, and 
answer ‘No’ when asked if you want a login shell to 
be accessible and then ‘Yes’ if you want the serial 
port to be enabled. Now start tcpser using SSH: 


For a genuine experience, 
and full compatibility with 
vintage BBS software, it's 
easy to emulate the classic 
Hayes AT command-set 


tcpser /dev/serial® -s 9600 -1 7 


(You can change 9600 to be your desired speed). 
Try connecting over serial again and this time 
you’ ll be able to enter AT commands, replacing 
phone numbers with domain names. 


Do more! 

Your original ‘comms’ software should 
be blissfully unaware that it is talking over the 
internet. There’s now another web of vintage 
BBSes to explore on your original machine, but 
why stop there? The Raspbian repositories are full 
of command-line software that can be accessed by 
your classic machine. Tweeting from an old 8-bit is 
always fun, so why not install ‘t’, a command-line 
Twitter client (github.com/sferik/t)? Of course, 
you can now do anything in the Raspbian shell 
that you can in an SSH session, so get your BBC 
Model B to operate LEDs and switches, or have your 
Commodore Amiga send Telegram messages! 


Add internet access to a vintage computer 


Polarity is the most 
common problem 
encountered when 
working with RS232 
Remember that TX 
(transmit) goes to 
RX (receive) and 
vice versa 


Top Tip 


Careful of 
weird wiring 


Do your research 
on your choice of 
classic machine. 
Some, such as 
the Cambridge 
Z88, use non- 
standard wiring to 
their connectors. 
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Mike 
Cook 


Veteran magazine 
author from the old 
days, writer of the 
Body Build series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, and 
Raspberry Pi Projects 
for Dummies. 


magpi.cc/MikeCook 


Warning! 
Drill safely 


Please use safety 
goggles and a desk 
clamp when drilling 


You'll Need 


i 


> Stripboard 
magpi.cc/ 
stripboard2 


> 40-pin, 2-row 
header pins 
magpi.cc/2rowpins 


> 2 x 40-pin, 1-row 
header pins 
magpi.cc/1rowpins 


Hack GraviTrax ` 
with Raspberry P1 


Make your Gravitrax layout trigger LEDs 


for a dazzling sound and light show 


to monitor the presence of a ball and how to 

use that to trigger sound. Then, last month 
we saw how to make animated LED parts run in 
background threads. Now we bring these two parts 
together and show you how to control them both 
using a text script and interface board. 


| n the first part of this series, we explored how 


Making the connection 

In the first part (magpi.cc/87), we 
simply mentioned that the ball sensors had to 
be connected to the GPIO pins with an external 
pull-up resistor and left it at that. Likewise, 
we just used several I?C devices on the same 
bus. However, for a practical useable system, 
we need to have all the input and output on a 
single board that allows simple flexibility for 
setting up different track layouts. So, we have 
designed a board which allows us to connect up 
to twelve sensors, five PC devices, and eight 
NeoPixel channels. 


The schematic 

The schematic (Figure 1) might look a bit 
repetitive, but that is the nature of what we are 
making. First of all, it incorporates the NeoPixel 
driving board we saw last month, but adds an 
option for powering the LEDs from an external 
supply to allow for much brighter displays. Then 
we have the input connectors: each has a 5.6KQ 
(5K6) pull-up resistor to 3.3 V (3V3) on the GPIO 
input pin. Note the centre pin is 3.3 V and the end 
pin is the input. Finally, we have five distributing 
PC connectors running on a single set of PC 
drivers, which also carry 5V power and ground. 
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Beginning the board 

We used a piece of 39-row by 37-hole 
stripboard to make our distribution board, and a 
small length of 40-way ribbon cable to connect it 
to our Raspberry Pi. Figure 2 (overleaf) shows how 
we cut the tracks on the rear of the board. Note 
the cuts between holes we used for the ribbon 
cable’s header pins; we did this with a scalpel, 
but you can use a small sharp knife for this - be 
careful! We found the best way to do this was to 
make two cuts across the track as close together 
as we could, and then remove the copper in 
between them with the blade. 


m We have designed a board 
which allows us to connect 
up to twelve sensors, 
five °C devices, and eight 
NeoPixel channels Ø 


Optional power jack 

Wear goggles for this step 
If you want to include a power jack for an external 
5V supply for the LEDs, we recommend you 
prepare for that first. Unfortunately, the standard 
board-mounting jack connectors are not too 
friendly for being mounted on a 0.1 inch pitch 
board, and you need a bit of work to make it fit. 
We found the best way is using a 1mm routing bit 
in the drill; or, at a push, a Dremel. You need to 
run together several holes in order to make this 
fit. Figure 3 (overleaf) shows what you need to do. 


We recommend you practise this on a small scrap 


of stripboard first before you attempt it on the 
large board. 


GraviTrax awaiting fitting 
of lights and sensors 


LED strips 
being tested 


c. es 
The interface board e 


sen Dëser K Å. that we've built 


it cate 
TSE 


i +5V (2&4) R Optional 
Construction Make link to power the LEDs same r 
H H 3 from the Raspberry Pi = et 
= When faced with a large piece of stripboard, 1000uF T A 
it is easy to get disorientated, so start by cutting l BAV HN 
B . Raspberry Pi GPIO number 
the tracks for the header pin and soldering that (connector number) | 0.1uF be 
TI WS2812b LED 
to the board. Then cut the tracks for the two IC ES 16 Strip Outputs 
š F P ê S Lai 
sockets and solder them in. This will give you a 14 74HCT4051 ` Ẹ S 
i ildi Z aa 
couple of good points of reference when building aout 1 p2 P80} 5 E: E> 
ae E ae a i 
up the circuit. The final layout you are aiming for cag A79 EE e E S 
is shown in Figure 4, but we suggest you leave 5i K jem 15 E 5 
d è ç GPIO 10 (19) L 7 9 14 
the flexible wires until last. If you want to see sake tin ele Ze Es t 
s A . [D> | L 13 7 
the layout before the flexible wires, there is an Stee ari H> T D- Pe ang AL 
intermediate diagram on our GitHub page. 13) >” Ne T Mozei connectors 
Gnd (6 & 14 & ee i +5V Gnd 
22 & 30) All Output 
pe ae “77 10K 
5K6 Optical sensor connectors ey 
GPIO 5 (29) —+ AAA GPIO 2 (3) 
=f Input Gnd = 
i 3V3 GPIO 3 (5) SSC 
Construction order Ee =a PE Connectors 
. H 477 
GPIO 6 (31) —— GPIO 4 (7) —H4 
We suggest that you first put in the copper BD ES? N +5 Gnd 
SDA! ' SCL 


wire links, shown as black lines. Then cut the aw = L 


tracks on the back. These are shown on the front GPIO 13 ac: GPIO 23 an d GPIO 12 GE $ 7 


view diagram as grey rectangles. Push a wire from —— | 
C SES SES 
the front into the hole of the track you want to cut, GPIO 19 SE GPIO 24 (18) + GPIO 16 oT 
flip the board over, and cut the track at the point EH ee 

H H SE 5V 5V 
the wire shows. This way, we have found there GPIO 26 E | cpio 17 (11) + GPIO 20 (38) — T 
is less chance of getting it wrong. Then add the 

. ` . S77 077 477 477 

header pins, followed by the resistors, capacitors, 


and power jack. Figure 1 Here's a schematic of the interface board used in this project 


me 
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SE Flexible wiring 

em = In order to complete the board, you need 
E to add flexible wires to make the connections not 
made by tracks alone. Note that the layout diagram 
is designed to show what connections you need 
to make, and not necessarily what route they 
should take. For example, header pins 19, 21, and 
23 are shown going over the top of the header; in 
practice, they should be routed round the left- 
hand side of the header pins, or even soldered on 
the underside of the board. Electricity is famously 
indifferent as to what colour wire it flows through 
- the colours we used are just to make the diagram 
more readable. 
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| Finishing off 

= We gathered the wires together using small 
2mm_-wide cable ties. This is essential to prevent 
the wires resting in between the header pins and 
making them look untidy. We also gathered the 
wires away from the edges of the board to allow 
labels to be put onto the board. It is vital that 
when you connect a sensor, you know what GPIO 
pin it is connected to. We used sticky-backed 
Figure 2 These are the tracks to cut on the rear side of the stripboard. Be careful! labels cut to the appropriate size, and stuck them 
on the board, then wrote on them with a fine- 
tipped pen (Figure 5). 
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J Cable ties are essential to 
prevent the wires resting 
in between the header 
pins and making them 
look untidy @ 
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The software 

The software is written under the Pygame 
framework, mainly for the ease of sound 
generation, and is shown in the traxscript.py 
listing. The window itself has only two clickable 
words: one to load in a new script, and the other 
to reload it. The script is simply a text file (see 
Figure 6 for an example) containing instructions 
of what to do and when. Each condition should be 
on a new line, and there are only two conditions: 
‘wher’ and ‘now’. The ‘wher’ condition syntax is: 
when (pin Number), pin state, delay value, play 
thread number or sound. The ‘now’ command 
Figure 3 Here's what cutting the slots for the power jack looks like. Once again, be careful simply plays a thread or sound immediately. 
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How it works 


i i sn gn H The software reads in the script and builds 
` WEE E SCH up a list of pins to watch and what to do when they 
are triggered. A triggering event is a change in the 
pin reading; this can be the pin going high (rises), 
going low (falls), or just changing state (changes). 
Note that a pin may appear as many times in the 
list, triggering different things on different, or the 


GPIO 20 


GPIO16 10 


board uses, or you specified an FL3731 that used a 
device address not connected to the board. For an 
incorrect pin number, the one in error is printed 
A Figure 4 Here's the full wiring of the interface board. Study it carefully out first. Adding a more rigorous file syntax- 


checking system could have been done, but would 


a) same, events. By building a list of the pins we want 
cro 12 qe 3 to monitor, we don’t waste time checking all the 
ae SULLA a e possible input pins. 
[d] io lo] Lol [1] [6] Lo] logo 
GPIO 26 o o o dfo 
20 e S S - S < 
[o] o og 
“ ek a ai Script errors 
SES 2 The beauty of using a script is that it 
PRI E E GOE documents and saves a specific layout. It does have 
Si Z its drawbacks, however. If a script contains errors, 
ms 30 o {a S rno: then the program is likely to crash. The most 
ae S ikely errors are that you specified a pin number 
aes a R ae that was not one of the twelve GPIO numbers the 


External Link for Internal 
5V LED power 5V LED power 


have made the code much longer. 


You now have a system that can greatly enhance a 
GraviTrax layout. Its simple scripting function can 
be a great introduction to using scripts for children. 
We do have some ideas for adding other things toa 
GraviTrax system. For now, though, feel the tug of 
gravity with added sound and lights. Ø 


Figure 6 


> Language: Text 


001. #, GraviTrax Script example 

002. now, sound @ 

003. now, ws 7 

004. when 24, rises, delay @.2, sound 4 
005. when 24, falls, delay 1.5, sound 1 
006. when 4, falls, delay 0.0, fl 6 
007. when 4, rises, delay 9.0, ws A 
008. when 23, falls, delay 0.0, ws 7 
009. now, fl A 


A Figure 5 The wires grouped and connections labelled in the finished product 
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traxscript.py 


> Language: Python 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 


020. 
021. 
022. 
023. 
024. 
025. 


026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 
035. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 


#!/usr/bin/env python 
# TraxScript 
# By Mike Cook November 2019 


import Neo_Thread as ws 
import FL3731_Thread as fl 
import RPi.GPIO as io 

from copy import deepcopy 
from tkinter import filedialog 
from tkinter import * 
import pygame 

import time 

import sys 

import os 

root = Tk() 


pygame.init() 
os.environ['SDL_VIDEO_WINDOW_POS'] = 'center' 
pygame.display.set_caption( 
"GraviTrax Script player") 
screen = pygame.display.set_mode([320,40], ð, 32) 
pygame.mixer.quit() 
pygame.mixer.init(frequency=22050, size = -16, 
channels = 2, buffer = 512) 
pygame.event.set_allowed(None) 
pygame.event.set_allowed([ 
pygame.KEYDOWN, pygame.QUIT, 
pygame .MOUSEBUTTONDOWN , 
pygame .MOUSEBUTTONUP ] 
) 
textHeight=24 ; black = (@, ð, ð) 
font = pygame.font.Font(None, textHeight) 
backCol = (120, 120, 120) ; lineCol = (196, 196, @) 


ws.initI0() 
f1.initI2c() 


def main(): 

initI0() 
loadResources() 
drawScreen() 
getFile() 
loadFile(scriptName) 
setupScript() 
while 1 : 

traxRun() 


046. 
047. 


048. 


049. 
050. 
051. 


052. 
053. 
054. 
055. 
056. 
057. 
058. 
059. 
060. 
061. 
062. 
063. 
064. 
065. 
066. 
067. 
068. 


069. 
070. 


071. 


072. 
073. 
074. 
075. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
085. 
086. 


def initI0(): 
global inPins, restartRec, loadRect, 
stopScript 
inPins = [17, 24, 23, 4, 5, 6, 13, 19, 26, 12, 
16, 
20] 
io.setmode(io.BCM); io.setwarnings(False) 
io.setup( 
inPins, io.IN, pull_up_down = io.PUD_UP) 
restartRec = pygame.Rect((238,7),(66,23)) 
loadRect = pygame.Rect((10,7),(97,23)) 
stopScript = ð 


def loadResources(): 

global soundFX, soundNames 

soundNames = ["owl", “Breaking Glass", 
"ComputerBeepsi", "CymbalCrash", 
"Fairydust", "Dogi", "Zoop", "Ya", 
"Pop", "Duck", "Gong", "Laser1", 
“"Laser2", "running", "Screech", 
"SpaceRipple", "Zoop", "Dog2", 
"DirtyWhir", "ComputerBeeps2", 
"AlienCreak2", "AlienCreak1" 


] 
soundFX = [pygame.mixer.Sound("sounds/" 

+ 
soundNames[effect ] 

+ "wav" 

for effect in 
range( 

ð, 
len(soundNames)) 

] 


def getFile(): 
global scriptName, root 
success = False 
while not success: 
root .withdraw() 
scriptName = filedialog.askopenfilename( 
initialdir = "/home/pi", 
title = "Select GraviTrax script", 
filetypes = (("txt files", "*.txt"), 
("all files", "*.*");)) 
if ".txt" in scriptName : 
success = True 
else : 
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DOWNLOAD 
THE FULL CODE: 


© magpi.cc/pibakery 


087. 
088. 
089. 
090. 
091. 
092. 
093. 
094. 
095. 
096. 


097. 


098. 


099. 
100. 
101. 
102. 
103. 
104. 
105. 
106. 
107. 
108. 
109. 
110. 
111. 
112. 
113. 
114. 
115. 
116. 
117. 
118. 
119. 
120. 
121. 
122. 
123. 
124. 
125. 


126. 
127. 
128. 
129. 


print("not a valid text file") 


def loadFile(fileName): 
global thingsToDo 
nameF = open(fileName, “r') 
thingsToDo = nameF.readlines() 
nameF ..close() 


def setupScript(): 
global pinToWatch, changeToMonitor, 
soundToPlay 
global actionDelay, wsToPlay, f1ToPlay, 
pendTime 
global nowIn, lastIn, trigNum, monitor, 
pendPlay 
pinToWatch = [] 
changeToMonitor = [] 
soundToPlay = [] 
actionDelay = [] 
wsToPlay = [] ; flToPlay = [] 
print("\nloading the script", len(thingsToDo), 
"lines") 
for move in range(@, len(thingsToDo)): 
line = str(thingsToDo[move] ) 
now = False 
for val in line.split(","): 
if "when" in val: 
pin = int(val[-2:]) 
if not(pin in inPins) : 
print("Pin",pin,"is not valid") 
pinToWatch. append(pin) 
elif"now” in val: 
now = True 
elif "falls" in val and not now: 
changeToMonitor.append(1) 
elif "rises" in val and not now: 
changeToMonitor.append(2) 
elif "changes" in val and not now: 
changeToMonitor..append(3) 
elif "delay" in val and not now: 
actionDelay.append(float(val[-3:])) 
elif "sound" in val or "ws" in val or 
"fl" in val: 
pram = int(val[-2:]) 
if "sound" in val: 
if not now: 
soundToPlay.append(pram) 


130. 
131. 
132. 
133. 
134. 
135. 
136. 
137. 
138. 
139. 
140. 
141. 
142. 
143. 
144. 
145. 
146. 
147. 
148. 
149. 
150. 
151. 
152. 
153. 
154. 
155; 
156. 
157. 
158. 
159. 
160. 
161. 
162. 
163. 
164. 
165. 
166. 
167. 
168. 
169. 
170. 
171. 
172. 
173. 
174. 
175. 


wsToPlay.append(-1) 
f1ToPlay.append(-1) 
else: 
soundFX[pram] .play() 
elif "ws" in val: 
if not now: 
soundToPlay.append(-1) 
wsToPlay.append(pram) 
f1ToPlay.append(-1) 
else: 
ws. StartWs2812Thread (pram) 
elif "fl" in val: 
if not now: 
soundToPlay.append(-1) 
wsToPlay.append(-1) 
f1ToPlay.append(pram) 
else: 
TL. startFL3731Thread(pram) 
checkForEvent() 
print("pin", pinToWatch) 
print("change", changeToMonitor) 
print("delay", actionDelay) 
print("sound", soundToPlay) 
print("ws animation", wsToPlay) 
print("fl animation", f1ToPlay) 
monitor = len(pinToWatch) 
nowIn = [@] * monitor 
lastIn = [0] * monitor 
pendPlay = [@] * monitor 
pendTime = [9.0] * monitor 
for i in range(@, monitor): 
lastIn[i] = io.input(pinToWatch[i]) 
print("Current pin states", lastIn) 


def traxRun(): 
global nowIn, lastIn, stopScript 
while stopScript == D : 
checkForEvent() 
for i in range(@, monitor): 
nowIn[i] = io.input(pinToWatch[i]) 
if lastIn[i] != nowIn[i] : 
#print("Current pin states", lastIn) 
lastIn[i] = nowIn[i] 
tmatch = changeToMonitor[i]-1 # 
match 
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traxscript.py 


> Language: Python 


176. 
177. 
178. 


179. 
180. 


181. 
182. 
183. 
184. 
185. 


186. 


187. 


188. 
189. 
190. 
191. 


192. 
193. 


194. 
195. 
196. 


197. 
198. 
199. 
200. 
201. 
202. 
203. 
204. 
205. 
206. 
207. 
208. 


209. 
210. 
211. 
212. 
213. 


if tmatch == 2: 
tmatch = nowIn[i] 


if changeToMonitor[i] != @ and 
nowIn[i] == tmatch: 
if soundToPlay[i] != -1: 
pendPlay[i] = 
soundToPlay[i] 
if wsToPlay[i] != -1: 
pendPlay[i] = wsToPlay[i] 
if f1ToPlay[i] != -1 : 
pendPlay[i] = f1ToPlay[i] 
pendTime[i] = time.time() + 
actionDelay[i] 
for i in range(@, monitor): # what to 
play now 


if pendTime[i] > 0.0 and time.time() 
>= pendTime[i]: 
if soundToPlay[i] != -1 : 
soundFX[soundToPlay[i]].play() 
if wsToPlay[i] != -1: 


ws. startws2812Thread(wsToPlay[i]) 
if flToPlay[i] != -1 : 


if flToPlay[i] == 99 : # stop 
clock 
TL. stopCount() 
else: 
f1.startFL3731Thread 
(f1ToPlay[i]) 


pendTime[i] = 0.0 
if stopScript == 1: 
getFile() 
loadFile(scriptName) 
setupScript() 
stopScript = 7 


def drawScreen(): 
screen. fill(backCol) 
pygame.draw.rect(screen, lineCol, loadRect, 1) 
pygame.draw.rect(screen, lineCol, restartRec, 1) 
drawWords("Load script", 14, 8, black, 
backCol) 
drawWords( "Restart", 244, 8, black, backCol) 
pygame.display.update() 


def drawWords(words, x, y, col, backCol) : 
textSurface = font.render(words, True, col, 


214. 
215. 
216. 
217. 
218. 
219. 
220. 
221. 
222. 
223. 
224. 
225. 
226. 
227. 
228. 
229. 
230. 
231. 
232. 
233. 
234. 
235. 
236. 
237. 
238. 
239. 
240. 
241. 
242. 
243. 
244. 
245. 
246. 
247. 
248. 
249. 
250. 
251. 
252. 
253. 
254. 
255. 
256. 
257. 
258. 
259. 
260. 


def 


def 


def 


def 


def 


if name == 


backCol) 
textRect = textSurface.get_rect() 
textRect.left = x # right for align right 
textRect.top = y 
screen.blit(textSurface, textRect) 
return textRect 
handleMouseDown(pos): # look at mouse down 
if loadRect.collidepoint(pos) : 
pygame.draw.rect(screen, lineCol, loadRect, @) 
elif restartRec.collidepoint(pos) : 
pygame.draw.rect(screen, lineCol, 
restartRec, 0) 
pygame.display.update() 


handleMouseUp(pos): 

global stopScript 

if loadRect.collidepoint(pos) : 
stopScript = 1 

if restartRec.collidepoint(pos) : 
stopScript = 2 

drawScreen() 


# look at mouse up 


constrain(val, min_val, max_val): 
return min(max_val, max(min_val, val)) 


terminate(): 
global root 
root.destroy 
pygame.mixer.quit() 
pygame.quit() # close pygame 
os._exit(1) 


# close down the program 


checkForEvent(): # see if we need to quit 
event = pygame.event.poll() 
if event.type == pygame.QUIT : 
terminate() 
if event.type == pygame.KEYDOWN : 
if event.key == pygame.K_ESCAPE : 
terminate() 
if event.type == pygame.MOUSEBUTTONUP : 
handleMouseUp(pygame.mouse.get_pos()) 
if event.type == pygame.MOUSEBUTTONDOWN : 
handleMouseDown(pygame.mouse.get_pos()) 


' main_': 
main() 
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Custom widgets 
with C and GTK 


used widgets in their default state; we’ve 

just created the widget with the gtk_<widget 
name>_new function call and used it. However, GIK 
does allow a degree of customisation of widgets by 
setting the properties for each. 

As an example, we are going to look at some of 

Simon long the properties of the basic GtkButton widget. Try 
is a software this example: 


engineer working 
for Raspberry Pi, 
responsible for 
the Raspberry { 

Pi Desktop on gtk_init (&argc, &argv); 
both Raspbian 

and Debian. 


[ n all the examples we’ve seen so far, we have 


void main (int argc, char *argv[]) 


GtkWidget *win = gtk_window_new ( 
rpf.io GTK_WINDOW_TOPLEVEL) ; 

GtkWidget *btn = 
gtk_button_new_with_label ( 
"Close window") ; 

R. signal connect (btn, "clicked", 
G_CALLBACK (end_program), NULL); 

g_signal_connect (win, "delete_event", 
G_CALLBACK (end_program), NULL); 


GtkWidget *btn2 = 


An Introduction 
to C & GUI INTRODUCTION 


Programming CaGul 


For further tutorials on how to start coding 


in C and creating GUIs with GTK, take a 
look at our new book, An Introduction to 

C & GUI Programming. Its 156 pages are 
packed with all the information you need 
to get started - no previous experience of 
C or GTK is required! 

magpi.cc/GUIbook 
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Change the properties of widgets to alter how they look 


gtk_button_new_with_label ( 
"My button") ; 


GtkWidget *box = gtk_vbox_new (FALSE, 5); 

gtk_box_pack_start (GTK_BOX (box), btn2, 
TRUE, TRUE, 91: 

gtk_box_pack_start (GTK_BOX (box), btn, 
TRUE, TRUE, 91: 

gtk_container_add (GTK_CONTAINER (win), 
box); 

gtk_widget_show_all (win); 

gtk_main (); 


This is familiar code from previous examples, but 
the highlighted line is new. 

g_object_set takes as arguments the name of 
a widget, followed by a NULL-terminated list of 
property names and property values. In this case, 
we are Setting the relief property of the GtkButton 
btn2 to GTK_RELIEF_NONE (see Figure 1). 


My button 


FERRER EERE EERE TERRE EERE EERE TERETE ERE R EERE REE E RES 


Close window. 


PII 


A Figure 1 A GtkButton with the relief property 
set to GTK_RELIEF_NONE 


The ‘relief’ of a GtkButton controls how the 
border looks. The borders of some GTK widgets 
have a degree of shading applied around them 
to provide a 3D appearance - by default, a 
GtkButton has this shading applied, which makes 
the button appear to stand out slightly from 
the window background. By setting the relief to 
GTK_RELIEF_NONE, this 3D shading is removed - if 
you run the program above, you should be able to 
clearly see the difference between the two buttons 
on the window. (You can use the TAB key to move 
the dotted outline between the buttons to show the 
difference more clearly.) 

Here’s another example. Remove the setting of 
the relief property, and change the name of the 
button by adding an underscore: 


GtkWidget *btn2 = 
gtk_button_new_with_label ( 
"My_button") ; 


You should end up with a button that looks like that 
in Figure 2. 
If you now set the use-underline property: 


g obiect set (G_OBJECT (btn2), 
“use-underline", TRUE, NULL); 


... the underscore will vanish, but will reappear 


m The borders of some GTK 
widgets have shading 
applied around them to 
provide a 3D appearance Ø 


under the "Di of ‘button’ if you hold down the ALT 
key on the keyboard (Figure 3, overleaf). 

All widgets have properties that can be set 
like this. As another example, try replacing the 
GtkButton with a GtkLabel: 


GtkWidget *lbl = gtk_label_new ( 
"My label"); 


...and then setting the angle property of the label to 
45 degrees: 


g_object_set (G_OBJECT (1bl), "angle", 
45.0, NULL); 


(Note that it is important to enter the angle as 


Figure 2 


Errn, 


My_button 


TUTORIAL | MägPi ro 


Close window 


45.0, rather than just as 45 — the value expected is 
a floating-point number, and adding the .o to the 
end of the value ensures that the compiler treats it 
as such.) 

You should end up with a window which looks 
like this, with the label text at a 45 degree angle to 
the horizontal (Figure 4, overleaf). 

In many cases, widgets also have dedicated 
functions to set each property which can be used 
instead of the generic g_object_set function 
(in the examples above, gtk_button_set_relief, 
gtk_button_set_use_underline, and 
gtk_label_set_angle, respectively). The advantage 
of g_object_set is that it can be used to set 
multiple properties in one line, which can shorten 
your code significantly. 

The GTK online documentation page for each 
widget lists all the properties and dedicated 
functions to set their values. For the two examples 
above, this can be found at magpi.cc/GtkButton 
and magpi.cc/GtkLabel — it’s worth having a look 
through the options for any widget you want to 
use. (These pages are also a good way of finding out 
what signals are generated by a widget when a user 
interacts with it.) 


An introduction to themes 

The other way that GTK widgets can be customised 
is by the use of a theme. A theme affects the 
appearance of every instance of a widget in 

every GTK application, rather than changing the 


A Figure 2 A GtkButton 
with an underline 
in the label and 
the use-underline 
property set to FALSE 
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> Figure 3 The same 
GtkButton, but with 
use-underline set 
to TRUE 


appearance of individual widgets one at a time. 
There is a selection of themes installed in Raspbian 
(and in most other Linux desktop distributions), in 
the directory /usr/share/themes. 

This directory contains a number of named 
folders, each of which is a theme for either GTK or 
other themeable applications. If anamed folder 
contains a subfolder named gtk-2.0, then the name 
of that folder is also a valid GIK 2 theme name. 

Which of the themes is currently used by GTK 
applications is usually controlled by the xsettings 
daemon, a process which runs in the background 
and provides configuration information to all 
desktop applications. On Raspbian, to change 
which theme is set in the daemon, you need to 
change a value in a configuration file. 


m Which theme is currently 
used by GTK applications 
is usually controlled by the 
xsettings daemon Ø 


To do this, check to see if there is a file called 
desktop.conf in the directory ~/.config/Ixsession/ 
LXDE-pi. If there isn’t, create one by copying the 
file /etc/xdg/lxsession/LXDE-pi/desktop.conf into 
that directory. 

If you then look in the desktop.conf file with 
a text editor, there is a section headed [GTK]. 
Somewhere under this heading is a line starting 
sNet/ThemeName=, which by default on Raspbian 
is set to Pix. If you change Pix in this line to the 


COREE R EERE EERE EERE KRE KRK KKR KKK Kry 
H 


Mybutton 


(pescccccccen } 
HIT 


Close window 
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A Figure 4 A GtkLabel with the angle property set to 45.0 


name of another GTK +2 theme (any directory 

in /usr/share/themes which includes a gtk-2.0 
subdirectory), the theme in use will automatically 
update and you should see every GTK application 
running redraw with the new theme. 

Creating a theme is not for the faint- 
hearted, but if you are interested, look inside 
one of the gtk-2.0 subfolders in the directory 
/usr/share/themes. 

The theme itself is in a file in this folder named 
gtkrc; there may also be a number of other 
subfolders containing graphical elements and 
other resources used by the theme. 

The gtkrc file is a plain text document which 
can be opened in your editor of choice. Most of 
them contain a number of style definitions, which 
consist of the word style followed by a number of 
lines contained within curly brackets. At the end of 
the file are lines which associate widgets with the 
styles previously defined. 

To change the appearance of a widget, find it 

in the list of associations at the end of the file, 
and note which style applies to it. Then locate 
the definition of that style within the file and try 
changing some of the parameters to see what 
happens. Do back up the original gtkrc file before 
you do this - or even better, copy the whole theme 
folder and give it anew name of your choice; set 
the ThemeName in desktop.conf to the name of 
your new theme, and create your own theme by 
modifying an existing one! fl 


= Get game design tips and 
tricks from the masters 


m Explore the code listings and 
find out how they work 


= Download and play game 
examples by Eben Upton 


m Learn how to code your own 
games with Pygame Zero 


This stunning 224-page hardback book not only tells 
the stories of some of the seminal video games of the 
1970s and 1980s, but shows you how to create your 
own games Inspired by them using Python and Pygame 
Zero, following examples programmed by Raspberry Pi 
founder Eben Upton. 


Available now: magpi.cc/store 
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Design a 3D printer 
pendant with BlocksCAD 


Use BlocksCAD to design a 3D pendant based on the Flower of Life pattern 


in a web browser, and it runs on Raspberry 
Pi. You drag and drop code blocks to design 
3D models that can be exported for 3D printing. 


B locksCAD is a 3D model editor that you use 


Dr Tracy In this project, you will use BlocksCAD to design 
Gardner a 3D pendant. The pendant uses a geometric 

design based on the ‘Flower of Life’, a design 
Tracy is a computer which is often found in historical art. 
scientist who spent If you have access to a 3D printer, then you can 
ten years working i x 
asia software print your pendant. The pendant is small and 
architect at IBM. only uses a little bit of filament, and it is quick to 
She now writes 3D-print. There’s a hoop on top of the pendant 

D D D D 
educational projects s 
f : so that you can put it on a necklace or cord. The 
or the Raspberry Pi e 
Foundation. pendant has a diameter of 40 mm, plus the hoop 
rpf.io/projects for hanging. It is 2mm thick, so it will 3D-print ES 
uite quickly. A The design is influenced by the Flower of Life pattern If you 
q i g like, you could research the Flower of Life and see if you can 
After this project, you’ll also be able to code create a design based on the Seed of Life pattern 


your own design and create a custom pendant. 
and a height of 2 (the unit here is millimetres). 
Cylinders are automatically centred along the 
X and Y axes. Select ‘not centered’ so that the 


Create a hoop pendant sits on the surface. (This means that the 
This project can be completed in a web Z axis value is larger than 0.) 
browser using BlocksCAD (blockscad3d.com). Click on the Render button after each change to 
| You'll Need Open Chromium and enter the BlocksCAD editor your code to see the results. 
URL: blockscad3d.com/editor. 
> Raspberry Pi 4 The design uses six interlocking hoops in the 
> BlocksCAD 3D centre, and a larger hoop around the outside. As 
blockscad3d.com mentioned, the pendant is 40mm wide, plus the Add more hoops 
San printer hoop for hanging, and is 2mm thick. Now, drag a difference block from Set Ops to 
(magpi.cc/69) Click 3D Shapes and drag a cylinder block to encase the cylinder. Add another cylinder block in 
the project. Create a cylinder with a radius of 12, the bottom space, and this time give it a radius of 11. 


*) translate X Rei Y Rei Z ‘oO j 


+) difference 


cylinder radius1 KH ka radius2 KH height 9 C RRR RHH HRD POO PEPEN f 


minus e O 
cylinder radius 11 radius2 height not centered : | 
S oa oo 9 


> Use a translate block 
to move the first 
hoop off centre 
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Drag blocks to the Project 
area to start building your 
3D-printed object 


This will remove a smaller cylinder from the centre. 
This creates a hoop. Click Render again to see it. 

If you like, you can click on the coloured square 
to change the colour used in the viewer. This does 
not affect the colour of your pendant, as that 
depends on the colour of the filament that you use. 

The design uses six intersecting hoops, and each 
hoop is moved out from the centre and rotated a 
different number of degrees. 

In the final design, there is no central hoop: the 
hoops are all moved out from the centre. 

Drag a translate block (from Transforms) around 
your code, and set x and y to 5. This moves the first 
hoop into position. 


Centre the hoop 

Now the hoop is a little off-centre. You need 
multiple copies of this hoop, rotated around the 
centre. First, create three equally spaced hoops. 

Add a count Loops block to create three hoops. 
To space the hoops, add a rotate Transforms block 
between the count loop and the translate block. 

In the count block, set the i variable from 1 to 3. 
Yov’ll need to insert an arithmetic block from Math 
and a variable (i) block from Variables into the Z 
field of the rotate block. 

The rotation moves each hoop by 120 x i degrees, 
so that the three hoops are distributed equally 
around the 360 degrees of a circle (360 / 3 = 120). 


BlocksCAD - Chromium 


m The design uses six 
intersecting hoops, each 
moved out from the centre 
and rotated Ø 


Look at the code and make sure you understand 
how it works. The finished design has six hoops 
rather than three. In the count block, set i from 1 
to 6, and set the Z rotation to 60, so it creates six 
equally spaced hoops. 


Add a border 

Next, add a border around the edge of the 
design. Create a centred hoop that touches the 
edges of the design. You can either do the maths to 
work out what the radius of the circle needs to be, 
or you can just create a circle and change the radius 
until it works. Either approach is fine! 


count with (EB trom 8 
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The preview window displays what the 
3D-printed object will look like. Click 
and drag to rotate the image around 


STL (bnan) * Generate STL 


Y By Using a count 
loop and a rotate 
block, you can 
quickly create 
multiple hoops 
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EF Vou can 3D-print the 
pendant in any colour 
filament you like 


TopTip è 


Bigger hoops 


The code adds a 
small hoop that 
can be used with 
elastic necklace 
thread. If you have 
a bigger cord or 
chain, you can 
adapt the code 

to create a bigger 
hanging hoop. 


EF The outer hoop 
should just touch 
the edges of the 
inner ones 


Encase your code with a union block from Set 
Ops, to join the border to the other hoops. 

Add a difference block to the plus section of 
union, and two cylinder blocks to make the hoop. 
The six hoops each have a radius of 12mm, so 
the border cylinder that you are making needs to be 

bigger than that. You could try setting the radius 
to 24mm. 

To make a hoop, the radius of the second 
cylinder in the difference block needs to be 1mm 
smaller than the radius of the first cylinder. 

Adjust the size of the cylinders until the border 
hoop just touches the outer edges of the six 
inner hoops. 

The radius should be around 20. (As mentioned 
in the introduction, the finished pendant will be 
4Omm in diameter.) 
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Work it out 
You could also use maths to work out 
the diameter. The diameter of each inner hoop 
is 24mm. If the hoops met at the centre of the 
pendant, the border hoop would need to have a 
radius of 24mm. But the inner hoops overlap, as 
they are translated 5mm along the X and Y axes. 
This removes a section from the radius. This 
section is on the arc, 5mm from the origin, so we 
need to remove 5mm from 24mm. Thus the inner 
radius of the border hoop should be 19 mm. 
Maths is really useful when you need to be 
accurate. But it’s fine to just change things until 
you get the result you need. 


Add a hanging hoop 
Now, add a small hanging hoop through 
which you can thread a cord to make a necklace. 
Click the [+] on the union block to add another 
section to add the new hoop. 
At the moment, the position of the hanging 
hoop isn’t very visually pleasing. 


A Adding blocks to create a small hanging hoop for 
the pendants cord 


Add a rotate block to move the inner hoops so 
that the hanging hoop is centred over one of the 
gaps between them. 


07 Experiment with shapes 
Experiment and change some values in your 
pendant. For example, change the number of hoops, 
or the rotation. You could also try to use cuboids 
(cubes) instead of cylinders to create a pattern. 


Export to STL 

BlocksCAD 3D can export an STL file for 
3D printing. Render your model and then click on 
Generate STL. Remember where you save the STL 
file. Now 3D-print your pendant using a filament 
of the colour of your choice. Very carefully remove 
the 3D print from the print bed. The pendant is 
thin, so it’s quite delicate. 

You might need to remove small strands of 
filament (especially from the hanging hoop) to tidy 
up the print. 

Thread the pendant on a chain or cord. If you 
want to use a thicker cord or necklace, then you can 
adjust the design to have a larger hanging hoop. L: 


A Try adjusting the design and using different shapes 
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TopTip è 


Issue 69 


Learn all about 
3D printing and 
setting up a low- 
cost 3D printer in 
issue 69 of The 
MagPi magazine 
(magpi.cc/69). 


m Very carefully remove the 
3D print from the print bed. 
The pendant is thin, so it's 
quite delicate Ø 


DOWNLOAD 
Flower of THE FULL CODE: 


life pendant 


> Language: BlocksCAD 


count with (EJ from "pm to Dei by (hull H 
"e B enee 
© translate x dÉ M< z d 
D 


difference 
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Kit & Gadget 
Guide 


e all know that Santa loves a mince 
W pie, but did you know that he is often C Ses 

partial to leaving Raspberry Pi boards 
under the tree of those on his ‘nice’ list? Well, 
if you got a Raspberry Pi for Christmas, then you 
may want to know about some of the awesome 
accessories you can get for it to really get the 
most out of your brand new computer. With so 
many cool accessories available, it can be a 
minefield knowing which ones to go 
for, so let us help you make up 
your own mind based on 
some ideas of ours. 


kl 
sl 


Essential add-ons 


Cool HATs 


E 
— 


Electronic starter kits 


N N 
9 si 


Gaming kits 


N 
ise) 


Gaming accessories 


N 
> 


Robot building kits 
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Raspberry Pi cases 


e think Raspberry Pi looks cool as it 
W is, but a case is a highly recommended 
accessory. Not only will it protect 
your Raspberry Pi and the delicate circuitry, it 


can also enhance the way some of the additional 
accessories work when used in combination. 


Official Raspberry Pi 4 Case 


If you want an affordable, reliable, and hackable 
case, then you cannot go wrong with the 

official Raspberry Pi case. Available in red and 
white or black and grey, this case will house 
your Raspberry Pi with ease. 

If you’re feeling 
adventurous, you 
can also hack the 
case to fit a small fan 
for cooling! 

£5 | magpi.cc/case 


SecurePi Case 


The SecurePi case looks very futuristic, especially 
with those angles! This case provides protective 
covers for your microSD card, USB, Ethernet and 
micro HDMI ports, and also has venting which 

is ideal for providing airflow for keeping your 
Raspberry Pi cool. It has space for the PoE HAT or 
Fan SHIM too! 

£10 | magpi.cc/securepi 


Pibow Coupe 4 


The Pibow by Raspberry Pi veterans Pimoroni is 

a classic Raspberry Pi case. Designed to be quick, 
easy, and cheap, the Pibow is made up of multiple 
layers of laser-cut acrylic. The Coupé version is 
slimmed down and gives easy access to Raspberry 
Pi’s GPIO and other inputs. 

£8 | magpi.cc/pibow 


Y Assembling the Pibow’s 
rainbow layers is fun 
and it looks great 


Aluminium Raspberry 
Pi 4 Case 


Aluminium is a 
great, lightweight 
metal that is also 
strong and is an ideal 
choice for a Raspberry Pi 

case because of these properties. 

This case looks great, especially if used as part 
of a 4K home media setup. With the holes, the 
cooling potential is also fantastic. 

£10 | magpi.cc/aluminium 


Anidees Raspberry Pi 4 Case 


Made of aluminium, the Anidees 
case provides ample 
protection for your precious 
Raspberry Pi. It comes 

in two colours ~ silver or 
black - and has an extra tall 
version to accommodate 
some HATs too. Oh, and it 
has an clear lid so you can see 
your Raspberry Pi in all its glory! 
£37 | magpi.cc/anidees 
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d Protect your 
ports and your 
Raspberry Pi with the 
SecurePi case 


Raspberry Pi 4 is 
the most powerful 
Raspberry Pi yet. 
All this horsepower 
means it can get 

a bit hot, though. 
The most effective 
cooling method 

is active cooling, 
which is typically 
accomplished with a 
fan. The Fan SHIM is 
perfect as it is low- 
profile, inexpensive 
and allows you 

to use the GPIO 
pins for other 
accessories. 


Y We love the clear 


acrylic lid that allows 
you to see inside 
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Essential add-ons 


Some accessories are essential for any Raspberry Pi fans. These accessories 
will be useful in pretty much every project, so take a look below 


A The official keyboard 
doubles as a USB hub 
with its three extra ports 


Raspberry Pi Keyboard 


Yov’ll need a keyboard in pretty much every 
Raspberry Pi project going. The Raspberry Pi 
Keyboard comes in a variety of layout options, and 
is available in two colour schemes. Not only does 
the keyboard connect via USB, it also has three 
additional USB 2.0 ports to free up ports on your 
Raspberry Pi. 

£16 | magpi.cc/keyboard 


D The Raspberry Pi Keyboard 
comes in a variety of 
layout options, and two 
colour schemes D 


Raspberry Pi 
Mouse 


Something 

simple, yet 

extremely 

effective and 

an essential 

accessory for any 

Raspberry Pi project, 

allowing you to navigate through 

any graphical user interface. The Raspberry Pi 
Mouse, when combined with the Raspberry Pi 
Keyboard, can be powered from the keyboard’s 
USB hub, keeping those precious ports free on 
your Raspberry Pi itself. 

£7 | magpi.cc/mouse 


mN 
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Ru i8+ Mini Wireless Keyboard 


If you want to go one step further, why not 
combine the keyboard and mouse into one and 
make it wireless while you’re at it? With the Rii i8 
Mini Wireless Keyboard with Touchpad, you can do 
just that! The supplied USB wireless dongle plugs 
into your Raspberry Pi and connects automatically. 
£18 | magpi.cc/wirelesskeys 


Retro Cube Bluetooth Speaker 


Why use a USB port or cable when you can use 
Bluetooth to keep things wireless? This little 
speaker, by retro gamepad specialists 8bitdo, 
is a fantastic little Bluetooth 
speaker. Styled like a 

retro console controller, Ki 

this rechargeable 

speaker provides up to 

eight hours play after 

one hour of charging. 

£18 | magpi.cc/speaker ` Lg i 


4 Port USB Hub 


Whilst Raspberry Pi has four USB ports, they can 
be used up quickly depending on how you 
are using it. Having a dedicated USB hub 
is always handy, particularly if you 
have a Raspberry Pi Zero. This 
four-port hub has both USB 
and micro USB connectors, so 
works on any Raspberry Pi! 

£8 | magpi.cc/usbhub 


We 
recommend... 


USB microSD 
card adapter 


If you're regularly 
writing microSD 

card images for your 
Raspberry Pi, a USB 
microSD card adapter 
is a great tool to have, 
especially if your 
computer doesn't 
have an SD card slot! 


magpi.cc/usbsd 


Y With both standard 
USB-A and micro 
USB ports, this hub 
has you covered 


Cool HATs 


There are hundreds of HATs available for Raspberry Pi. As they 
are so easy to connect and set up, they are a perfect accessory 


H 


http://pimoroni.com 
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The Enviro is a fantastic piece of kit. It allows 
you to monitor a number of environmental 
factors, such as temperature, light, and sound. 
The fully-featured Enviro + Air Quality version 
also includes a gas sensor. Simply connect to 
your Raspberry Pi, install the code, and you’ ll 
have your very own monitoring station. 

£28 | magpi.cc/enviro 


Display-O-Tron HAT 


The Display-O-Tron HAT is a fantastic little 
screen, backlit with controllable RGB LEDs, has six 
capacitive touch buttons, and also features a small 
LED bar graph! If you want to run your Raspberry Pi 
‘headless’ (i.e. without a screen connected), then 
the Display-O-Tron HAT is ideal. 

£23 | magpi.cc/displayotron 


Y ideal for 
displaying 

data without 
a monitor 


If you want something 
a little more ‘out of 
this world’, then the 
Sense HAT is a perfect choice. 
Used on the International Space Station 
as part of AstroPi, the Sense HAT monitors 
temperature, humidity, pressure, and orientation. 
It also has an 8x8 LED matrix on top for additional 
display purposes. 

£30 | magpi.cc/sensehat 


TV on a Raspberry Pi? Yes, that’s right! With 
the TV HAT and a bit of configuration, you can 
set your Raspberry Pi to receive 

terrestrial television channels. 
It is even possible to 
record TV shows so 
that you can watch A 
them back at your T j| 
leisure too! 

£20 | magpi.cc/tvhat 


A DAC (digital-to-analogue converter) is a 
must for anybody who takes listening to music 
seriously. The quality of your music is much 
better when a DAC is used, and the pHAT DAC is 
a great little accessory that you can use to play 
music to your heart’s content. 

£13 | magpi.cc/phatdac 
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A As used on the ISS, 
the Sense HAT is 
packed with sensors 
and features 


We 
recommend... 


Resistor lead 
bending tool 


Prototyping is 
essential, and this 
handy tool makes 
it easier to bend 
those resistors into 
breadboard- 
friendly form. 


magpi.cc/resistorbend 
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Electronic starter kits 


A Raspberry Pi can do more than play retro games or videos. Thanks to 


the GPIO pins, you can interact with a variety of sensors and devices 


Jam HAT (LED & 
Buzzer Board) P 


If you’re not that 
good at soldering 

and want something 
that is pre-assembled 
in a HAT form, then 
the Jam HAT is a great 


alternative. With LEDs, 
buttons and a buzzer, you 

can use the code examples provided to create your 
own unique projects, all for under a tenner! 

£7 | magpi.cc/jamhat 


CamJam EdukKit 


Prototyping is a great way to start 
experimenting with sensors, 
LEDs, buzzers, and 

everything else that can be 
connected to a Raspberry 

Pi. The CamJam EduKit 

contains a breadboard, an 
essential tool that allows you 

to make your own prototype 
circuits without soldering a thing, 
as well as other essential components. 
£5 | magpi.cc/edukit 


Feeling adventurous? Have 0 go at building your own Raspberry Pi-powered gaming setup 


TinyPi Pro 


What good is a portable games 
console unless it fits in the smallest 
of pockets? Enter the TinyPi Pro 

- a do-it-yourself kit that isa 

small but perfectly formed games 
console. These sell like hot cakes, 
but are a real gem if you can get a hold of one, 
and you’ll learn lots during the build. 

£90 | magpi.cc/tinypipro 


BASIC Monster Arcade 
Controller Kit 


If the full Picade kit is a bit too lavish for you, 
then the Arcade Controller Kit by Monster is a 
great alternative. With this kit, you’ ll build an 
arcade stick that houses your 
Raspberry Pi, which can be 
connected to your TV fora 
more portable setup. 

£60 | magpi.cc/monsterbasic 
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PIGRRL 2.0 kit 


If you fancy 3D-printing your own case (designs 
are included) and putting your build skills to the 
test, then consider the PiGRRL 2.0 kit. You'll need 
to supply the Raspberry Pi and the case, but you’ ll 
have a great time putting it all together and testing 
it out when complete. 

£56 | magpi.ce/pigrll2 


When it comes to arcade kits, 
Pimoroni’s Picade is king, and for 
very good reason! The kit is expertly 
crafted and has been refined since 
it was initially launched after a 
successful Kickstarter campaign. 
It comes in two options — with an 
8-inch or 10-inch display - and 
with detailed step-by-step build 
instructions and videos. 

£150 to £195 | magpi.ce/picade 


Gaming accessories 


Raspberry Pi is an excellent choice for emulating and playing retro games. 
But what accessories should you consider? 


SN30 Pro+ Bluetooth Gamepad 


There are so many controllers to choose from, 
but 8BitDo’s wireless gamepads are an excellent 
choice. The quality and looks of these controllers 
really add that ‘wow’ factor to any retro gaming 
build. This one has analogue thumbsticks and 
comes in a choice of three colours. 

£45 | magpi.cc/sn30pro 


MEGAPi Case 


If you’re going to build a retro gaming system, 
what better than this fantastic scaled version of 
the Sega Mega Drive from RetroFlag? Their cases 
are spectacularly well designed and this one is the 
perfect combination of nostalgia and functionality, 
especially with the programmable shutdown 
buttons and cooling fan. 

£25 | magpi.cc/megapi 


Why not go one step further and make 

a portable retro gaming system? The 

GPi Case is a beautiful replica of a retro 
handheld console, and the attention to 
detail is breathtaking. A Raspberry Pi Zero 
(not supplied) is housed in a detachable 
cartridge and it even runs off regular AA 
batteries for gaming on-the-go. 

£60 | magpi.cc/gpicase 


D A Raspberry Pi 
Zero is housed 
in 0 detachable 
cartridge Di 


Classic USB Games Controller 


If you want functionality without breaking the 
bank, then the classic USB game controller 

is an excellent choice. Modelled on a classic 
controller, this connects to your Raspberry Pi via 
USB - and a generous cable length means you 
don’t need to sit too close to your TV to play! 

£8 | magpi.cc/usbcontroller 


retro-bits 
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pETROrL pG GPi CASE 


A Create your own 
portable retro 
system with this 
stunning case 


We 
recommend... 


Micro USB to 
USB-C adapter 


This little adapter lets 
you use your existing 
micro USB power 
supplies with the new- 
style USB-C ports on 
Raspberry Pi 4. 


magpi.cc/microusbc 


d An extra-long 1.8m 
cable gives this 
classic controller 
the edge 
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Robot building kits 


R2-D2 or C-3P0? Or are you more of a BB-8 fan? No matter your 
favourite, you can always build your own with one of these kits 


~ 


CamJam EduKit #3 


If you are after a budget kit, this CamJam one 
is a great introduction to robotics. You’ll need 
to supply your own Raspberry Pi and chassis 
(something to attach the kit to), but it’s a great 
way of getting into the world of robotics before 
delving into something a little more complex. 
£18 | magpi.cc/edukit3 


N 


These types of robots are used in manufacturing and 
engineering plants — well, maybe not Raspberry Pi 
versions, but the same style. With the MeArm kit, 
you can build a robotic arm that is controlled using 
the two supplied thumbsticks (or with code). An 
ideal option for a budding robotics engineer! 

£70 | magpi.cc/mearm 


A Build your own 
robotic arm with 
this affordable kit 


The STS-Pi is a great little robot kit that gives 

you the bare bones to build a two-wheeled roving 
robot. You’ll need to supply a Raspberry Pi, Camera 
Module, and motor driver (such as the Explorer 
pHAT), but you’ll learn the basics of robotics with 
this nifty kit. 

£23 | magpi.cc/stspi 
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Y One of the most 
rugged robots 
around, it’s a 

real monster! 


MonsterBorg 


The title says it all here: this is the ultimate 
Raspberry Pi robot and is designed to withstand 
some punishment. The chassis is rugged and 
made of aluminium, and the wheels make it a 
great off-road choice, especially with the three 
hours run time. Oh, and it runs any side up, too! 
£210 | magpi.cc/monsterborg 


We 
recommend... 


MotoZero 


A motor driver 
capable of powering 
four motors, this 
board is a great and 
affordable choice for 
any robotic build. 


magpi.cc/motozero 


Picade X HAT 
USB-C 


If you fancy building 
your own arcade 
setup without a 

kit, this add-on 
makes controller 
configuration a 
breeze. It works with 
the Pi 4 too! 


magpi.cc/xhat 


Picade 
Plasma kit 


Want flashy LED 
arcade buttons 
instead of plain ones? 
This kit adds all the 
jazziness you'll need! It 
comes in six- or ten- 
button options. 


magpi.cc/picadeplasma 
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Enviro m 


BUILT-IN 
SENSORS: 
BMEz280 
temperature/ 
pressure/ 
humidity, 
LTR559 
light/proximity, 
SPHO645LM4H-B 
noise 


DISPLAY: 
0.96-inch 
colour LCD 
(160x80) 


DIMENSIONS: 
65*30x8.5 mm 


Verdict 


Lacks the gas 
sensor of the 
Enviro + Air 
Quality board, but 
features the same 
mini LCD screen 
to display your 
environmental 
data without 

a monitor. 


8 10 
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K Pimoroni K magpi.cc/enviro K £28 / $30 
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An environment-sensing board with a mini 
LCD screen to display data. By Phil King 


board enables you to measure temperature, 

pressure, humidity, light, and noise levels. 
While it lacks the gas sensor, ADC, and particular 
matter sensor connector of the Enviro + Air Quality 
version (reviewed in The MagPi #83, magpi.cc/83), 
it retains the cool mini LCD colour screen to display 
data — ideal when using your Raspberry Pi in a 
headless setup, without a monitor. 

It also features the same slimline pHAT form 
factor to match the size of a Raspberry Pi Zero, 
although it can be used with any Raspberry 
Pi model. 


D esigned for indoor monitoring, the Enviro 


Sensing the world 
The Enviro’s BME280 weather sensor monitors 
temperature, barometric pressure, and humidity. 
As on the Enviro +, this has been positioned at the 
left edge of the board, away from Raspberry Pi’ s 
CPU, and there’s even a little smile-shaped slot 
around it to help reduce heat radiated through 
the board. Even so, you’ll need to adjust its 
temperature reading for accuracy (by measuring 
that of the CPU itself and deducting a factor of it). 
A smartphone-style LTR-559 light and proximity 
sensor detects the ambient light level and also 
proves handy as a substitute for a push-button 
when you put your finger on it. The board’s tiny 
MEMs microphone measures sound levels, useful 
for monitoring noise pollution, and can also be 
used to record audio. 


HEHEHE 


Enviro HAT Mini 
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E enviro-monitoring 
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A The rear of the board, showing the pre-soldered 
female GPIO header 


At the time of writing, most of the code 
examples provided with the Python library 
(magpi.cc/enviroGH) are aimed at the Enviro + Air 
Quality board. However, it’s easy to edit the code 
for missing sensors from the all-in-one example 
to get it showing rolling graphs for temperature, 
pressure, humidity, and light level on the LCD. 
There are also a couple of examples that make use 
of the mic to plot noise levels and frequencies. 

If you don’t need to test air quality and just want 
a simple environmental sensor with a built-in 
display, the Enviro is ideal. The light sensor could 
also come in handy for use in IoT setups, such as to 
trigger your lights to come on when the light level 
falls below a certain level. 

If you also require motion/direction sensing, 
the original Enviro pHAT is still available (albeit 
without the mini LCD). HI 


NS 


clas NEW 


MODERN MAKER 


MAKE BUILD HACK 


HackSpace 


TECHNOLOGY IN YOUR HANDS 


CREATE 


ISSUE #26 


hsmag.cc 


4 Available on the GET IT ON 
@ AppStore P> Google Play 


WE Magri | REVIEW 


SmartiP1 Touch 2 


Verdict 


A great case if you 
need a stationary 
tablet, although 
making it mobile 
might be a little 
more tricky. 


8 10 


> The Pi Hut K magpi.cc/smartipi2 K £24 / S32 


A very smart-looking case for the discerning touchscreen user. 
Rob Zwetsloot puts one together for a test 


e feel like we slightly overlooked the 
W original SmartiPi case, so we’re happy 

to rectify this with the brand new 
SmartiPi Touch 2. 

This case is designed to work with the 7-inch 
official Raspberry Pi touchscreen, effectively 
turning a Raspberry Pi into a (bulky) tablet or fixed 
monitor. As there’s no real room for rechargeable 
batteries as standard, it works better in a more 
fixed environment. 


M You can choose little 
feet for the display, or a 
foldable stand D 


A Itlooks sleek and compact from the front 


78 | magpicc | SmartiPi Touch 2 


One of the unique features of the SmartiPi is 
the interchangeable faceplates on the front of the 
case. As well as allowing for a Raspberry Pi Camera 
Module to be mounted inside the case, it enables 
you to add a Lego-compatible plate. It’s not large, 
so you can’t do much with it, but it’s a very neat 
addition nonetheless. 


Smart build 
Construction is extremely easy, just requiring 
you poke some ribbon cables in the right place 
and fasten and tighten some screws to make sure 
everything is mounted properly. You can choose 
little feet for the display, or a foldable stand so 
you can angle the screen - both are easy to install 
and even replace. There’s also a little case fan and 
vented rear panel to keep your Raspberry Pi cool. 
It’s extremely well thought out, and a very handy 
case if you need a compact ‘Raspberry Pi with 
screen’ solution that just looks nice. D 


A The additional case fan and vents can be handy for intensive loads 


Use Raspberry Pi 4 as a desktop 
PC and 4K home media centre 


Be inspired by incredible 
projects made by other people 


Learn how to code and make 
with our step-by-step tutorials 


Find out about the top kits and 
accessories for your projects 


MéigPi 


10 Best: 


Take your making skills to the next level 
with these advanced kits and projects 


0, you’ve looked over the tips and tools 

(page 26), got yourself some cool accessories 

(page 68), and now you’re looking for a 
challenge. Something fun to build. A big new year 
project. We have some great ideas for you... 


A serious robot, the DiddyBorg is diddy in name only and a true 
Raspberry Pi automated monster. Program it, remote-control it, or 


just have it sitting pretty in your workshop. Your choice. 
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We've covered this project in a previous issue of The MagPi, but this project 
deserves mentioning again: with some 3D-printed parts, and some ingenious 
Adafruit PCB parts, you too can make a handheld console. 


This big build by Bob Clagett is 
incredibly thorough, and shows 

you how to build a wooden arcade 
cabinet from scratch, complete with 
lights and cool art. 


If an arcade machine is a bit too 

new for you, how about something a 
bit more classic and physical like a 
pinball table? This one repurposes an 
old bed. 


REVIEW | MägPi mmm 
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the community, especially as the 
mirror software part is so easily done. 
Building a frame is quite fun anda 
great first-time carpentry project. 
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Futuristic plastic printing 


mn eS 


rinter controller 


a Laptop 


Take Raspberry Pi Have a new 3D printer? How about interfacing it with Raspberry Pi 
anywhere using the amazing OctoPrint? It's especially helpful if you think of 


Ke 2 something cool to print while on the go. 
This tiny laptop project allows you 


to bring your Raspberry Pi with you octoprint.org 
wherever you want to go, and do 


some work while you're there. 


magpi.cc/74 


Home assistant 


Voice-controlled computer 


A number of big voice services are available on Raspberry Pi. Alexa is one of the 
easiest to get onto Raspberry Pi, thanks to the excellent AlexaPi software. 


magpi.cc/alexapi 


A Smart CCTV system 


Recognise your visitors 


CCTV cameras with Raspberry Pi are not too difficult to put 
together. We like this project as it uses computer vision and face 
detection to recognise known people as well. 


magpi.cc/smartCCTV 


a 3D scanner 


LEARN TO PROGRAM! 


Scan your friends 
Got the tools and the skills to raise a barn and then 


some, but lacking the ability to print ‘Hello World’? 
Take a look at our books on controlling electronics 
with Python and GPIO Zero (magpi.cc/GPIOZbook) 
magpi.cc/3dscanner and learning C (magpi.cc/CGUI). 


This big project is great for showing off at your local Raspberry Jam or maker 
event. It takes a lot of Raspberry Pi boards and cameras to create the project, 
but it does capture impressive 3D scans. 
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Discover this statistical language and explore data science. By Lucy Hattersley 


DataCamp 


S DataCamp Ris a language intrinsically 

E linked to data and statistical 

= Price: analysis. Popular with scientists 
S] FREE (or $568 peryear) and number crunchers, it has 


datacamp.com fans around the globe. 


If you’ve spent a lot of time in 
Python and other programming 
languages, some of the 
features of R are confusing at 
first. Assignment operators 
are arrows, and lists are one- 
indexed (with the first item 
starting at position one, rather 
than zero). All of this is designed 
to make working with large 
datasets more friendly. 

DataCamp is a great learning 
resource for R, Python, and SQL. 


i.e Lo 


Introduction to R 


Core Peines 


It uses a web-based code editor 
(which admittedly, we have 
mixed feelings about). The basic 
course is free, and you can pay 
for a DataCamp subscription to 
access a wide range of advanced 


courses. A subscription isn’t 
cheap though, coming in at 
over $568 per year, although 
there are frequent half-price 
sales and it is aimed at budding 
data scientists. Hl 


Data sources 


KM — 


19 Places to Find Free Data Sets for 
Data Science Projects 


DATA 

The US and UK governments have made 
huge datasets open. Everything from 
business figures to the environment, through 
mapping and spending, can be found online. 
data.gov.uk 
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KAGGLE 

Kaggle is an online community owned by 
Google. It's a great resource for datasets, 
as well as featuring blogs, competitions, 
and tools. 

kaggle.com/datasets 


DATAQUEST 

There's a range of datasets around, from 
Google, Wikipedia, and Amazon, and even 
news outlets like BuzzFeed. Dataquest has a 
great list of sources for you to bookmark. 
magpi.cc/freedatasets 
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D Coursera 


= Duke University ie HEE ars 
=) & John Hopkins 
2 University 
2 Price: 
£38 / $49 (per month) 
coursera.org 
O D 
o R websites 
Geer offers a range of ep let e probability Bookmark these 
courses from universities. and Bayes’ rule. It covers 
There are two that should sampling methods, and forms webpages while 
be of interest. The first is part of a larger Statistics with learning R 
Introduction to Probability R Specialization, which you can 
and Data from Duke University take to learn more about R. R Acten 
(magpi.cc/courseraprobability), The second suggested Practical Data Science wih R 
with a 4.7 star rating. Led course is R Programming from imc 
by Mine Cetinkaya-Rundel, John Hopkins University 
Associate Professor of the (magpi.cc/courserar). This will 
Practice Department of get you closer to the R language. 
Statistical Science, the course After a seven-day free trial, 
features R, but it’s more about you’ ll pay Coursera a monthly 
learning to crank data. It gives fee to access the courses. Hl 
R-BLOGGERS 
R-bloggers is a website 
N aggregator for blogs on R. 
Introduction to R In it, you'll find the latest 
contributions from hundreds of 
fo T D AT a S C l e nC e different R bloggers. 
r-bloggers.com 
A Microsoft We’re big fans of the edX Its Introduction to R for Data R-EXERCISES 
E platform, which offers a range Science course is provided by R-exercises aims to help 
6 Price: FREE ($99 certificate) of courses from respected Microsoft, and runs on the people develop and improve 
B magpi.cc/edxr universities and organisations. | DataCamp platform (so it’s their R programming skills. 
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soccnge 


an interactive web approach). 
This is interspersed with 
video tutorials and short 


R-exercises was initiated and 
is maintained by Research for 
Decisions, a Dutch research/ 


aater 1o P or Ota cen online quizzes. And the edX consulting firm. 
P l ` community is vibrant, with an r-exercises.com 
os active forum that is ready to 

SS 


answer any questions you 
might have. 

It’s an accessible course and, 
thanks to being on edX, you can 
enrol and take the course for 
free. You only need to pay to get 
a certificate at the end. Hl 


REVOLUTIONS 

Revolutions is a blog 
dedicated to news for the 

R community. It's a great 

place to find out recent 
developments and news. 
blog.revolutionanalytics.com 
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Andrew Suttle 


A young student who makes Raspberry Pi-powered 
robots at a university club 


Y While some go there to 
build physical projects, 
others learn to code 


> Day job Student | 


Ithough Andrew is 
A currently in year nine, 
that hasn’t stopped him 
from participating in what was 
once the very grown-up activity 
of building robots. 

“My first Raspberry Jam was 
CamJam in autumn 2013, when I 
showed some programs | had 
written,” Andrew tells us. “I also 
enjoy developing robots and 
doing electronics. I first went to 
the Colchester club run by John 
Woods in 2016, when I built a 
robot car using a Raspberry Pi. 
The Colchester club is run at the 
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> Commun 


university and I like going there 
very much. The lab we use has all 
new oscilloscopes and I used 
them recently with some op-amp 
circuits. I also built my own 
oscilloscope from a kit and John 
Woods helped me get it working, 
as I had not soldered one of the 
connections properly. I took my 
oscilloscope into school and used 
it there.” 

Andrew isn’t the only young 
person at the club, either: 
“Several other children from my 
school have also gone to the club 
and I have built projects with 


ity role Club attendee and promoter 


them. We made an ‘I ¥ Pi’ team 
and entered competitions. We 
also had a ‘Pi Rates’ team. My 
brother also goes to the club. He 
is building a security project with 
Arduino, and I might use some of 
his ideas in a programming 
course Iam making.” 


What kind of people attend? 

At the moment, it is all children 
aged 8 to 14 who come along 
with their parents, but we don’t 
have set age limits. The 
youngest children usually want 
to learn Python; the older 
children usually have a project 
of their own that they want to 
work on. People often drop in 
for a few sessions and solve a 
particular problem and then 
stop attending. We have had 


A Dr John Woods is a senior 


lecturer at the University of 
Essex, and also the runs the club 


some stay for years and they are 
all from different local schools. 

One boy, Taylor, came 
regularly until he was 18. He 
developed several AI projects. 
He got a scholarship to 
Cambridge University, and 
graduates this year. 

Other members have entered 
competitions and we have had 
members win in the ‘BigBang’, 
‘Pioneers’, and ‘EasternDigital’ 
competitions. EasternDigital is 
an ‘adult’ competition for 
companies and one of the 
winners three years ago was ten 
years old; he was too young for 
their children’s competition! 


What projects have you or other 
people made there? 

As well as the AI projects I have 
mentioned, we have had 
members developing robotic 
arms. Then there was a flight 
control system for model 
aircraft and several robot cars. 


D Some children are doing their own 
Python projects, with Python always 
a popular language D 


Several children have 
gravitated towards embedded 
systems. Two children, Zara and 
Andrew, developed a plant 
monitoring system. 


What are you working on at 
the moment? 

Some of the younger children 
who are new to the club are 
doing directed tasks. Samuel, 
aged eight, and Xingtong, aged 
eleven, are both working on 
TicTacToe. But we do very 
little teaching. 

Some children are doing their 
own Python projects, with 
Python always a popular 
language. Robyn, aged twelve, 
has made a Mastermind-style 


game linked with Hangman. 
Andrew, now aged 14, has 
developed a version of Conway’s 
game of life. 

There are also several Arduino 
projects on the go. Victor, aged 
eleven, has just finished his 
security control system which is 
based on an Arduino Uno and 
written in C. 

There are always robots. We 
have a robot arena that is 
purpose-built for the 
development of robots, and we 
have a lot of knowledge and 
resources to support a robot 
project. The arena is 100 square 
metres in area, and has a six- 
metre-high ceiling to 
accommodate flying robots. M 
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A plant monitor 
created by two 
children at the club 


Using an oscilloscope, 
attendees were able to 
explore modulation 


Colchester 
Coding and 
Robotics Club 


“The club is located at 
Essex University and 
uses a lab run by the 
Computer Science 
and Electronic 
Engineering (CSEE) 
school. Getting to the 
university is easiest by 
car, with parking free 
on Sunday. The club is 
usually in the second- 
floor lab in building 
L77-1NW, which is 
located immediately 
opposite the STEM 
centre in Square 1. We 
meet most Sundays 
during university 

term time." 
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This Month in 
Raspberry Di 


Mag P Monday 


Amazing projects direct from our Twitter 


very Monday we ask the question: have you 

made something with a Raspberry Pi over 

the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 
they’ve made. Here is a small fraction of them. 
Follow along at the hashtag #MagPiMonday. Ei 


3D mapping is some dark magic, but 
Lorraine has managed to pull it off for 
her incredible animated tree lights 


. Amazing work from a near ten-year-old, 


and a great example of fun and simple 
Raspberry Pi projects 


People don't mess about with Pi Wars, 
especially when materials can mean a 
win or loss 


This is a very cool and simplistic info 
cube that we kinda want 


Who could the mysterious beastie be? 


This is a cool, abstract project that 
makes great use of the Twitter API 


We love a tiny retro console, and this 
Raspberry Pi Zero-sized one is lovely 


Razvan sent us a load of great projects 
with very practical uses 


Another month, another excellent- 
looking Pip-Boy build 
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A Lorraine Underwood Le 


Replying to @TheMagPi 


| 3d mapped the Christmas tree lights! 
twitter.com/LMcUnderwood/s... 

Blog post here: lorraine. mcunderwood.org/christmas 
tree/ 


Amem 
CannonFodde 


Replying to @TheMagP?i 


Tom (10 very soon) soldered up his @ThePiHut 
Christmas Tree by @RachelRayns and setup the 
Raspberry with no help from me 


LÉI Laurence Molloy 
- y 


PTheMagi 


#MagPiMonday 


We have a night time intruder in our house. It ripped a 
food pouch to shreds & sent our cat mental the other 
night 


| set something up ready to catch our night time 
intruder in the act. I'll set it in front of our cat flap 
(which it broke in a previous forced entry) 


Made a Raspberri Py remote control for a fellow 
Psychologist. Simple Rx/Tx IR LED connected to three 
pins, LIRC working. Doubles as a webserver he can 
access through OpenVPN to start/stop his heating via 
two Wireless S20 Sonoff smart plugs I've installed Linux 


on. 


MägPi 


Q orienrebots 


I've been making parts for my piwars robot, specifically 
material study to see if | can make battery retaining 
dips that bend a little, in PLA, Blog post to come. 


(Ba daniel brady 

CH 

I finished off the code for this info display at home. 
Shows the time, buses due, and max temp. I'll also be 
adding precipitation and bin day reminders soon. 


Made using a Raspberry PI Zero and a @pimoron 
Ubercom LED matrix 


#MagPiMonday 


Le RaspberryPint 
hettagP 


I have modified one of my projects to be more 
Christmasy. It connects to Twitter and sets each of 180 
neopixels to a colour representing someone it follows. 
Each pixel represents a tweet or retweet. It constantly heMagri 
changes as tweets arrive. | presented at last meetup. 
#MagPMonday 


Finished one of my #tinyretroportables. Has a SSOmah 
battery, li-ion charging, 3w mono amp & the tiniest 
5mm diameter speaker | could find! And the whole 
thing is only — "em thick 


wm —— 


Justin Hart 
hart 


Ké 


Almost finished the pipboy, all systems working, just a 
bit more python and paint to go! #MagPiMonday 
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Raspberry P15 
turns eight in 2020! 


Celebrate your favourite microcomputer on 29 February 2020 at 0 Raspberry Jam near you 
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mg, 


February, the greatest month, receives an 

additional day, which just so happens to be 
the true birth-date of Raspberry Pi: 29 February. 
It also lands on a Saturday, which makes it perfect 
for the return of the Birthday Jams! Here’s a special 
message from Philip Colligan, CEO of the Raspberry 
Pi Foundation, on how you can get involved. 


? 020 is one of those rare years: a leap year. 


Celebrate at a Raspberry Jam 
Raspberry Jams are community-led meet-ups 
that bring people together to share, connect, and 
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learn from each other. The first one was held in 
Manchester in 2012, and so far Jams have been held 
in more than 70 countries — and that’s just the 
ones we know about. 

While Jams take place throughout the year, 
there’s a special tradition of Jams celebrating the 
birthday of the Raspberry Pi computer. This year, 
there were over 130 Raspberry Jam events in 39 
countries, attended by 8000 people! 


Register your Birthday Jam and 

we'll send you some special swag 

Next year, because it’s a big birthday, well be 
sending a special box of swag to any Jam that is 
taking place between Saturday 15 February and 
Sunday 15 March 2020. 

It’s really simple to register your Birthday Jam: 
just fill in the Raspberry Jam submission form 
(magpi.cc/jamform), including a valid event 
information URL linking to a webpage with more 
information about your event. 

Wed prefer you to link to a public ticketing 
system (e.g. Eventbrite) if possible, but we know 
some libraries and community centres have 
restrictions that prevent them from doing this. 

In order to ensure that your pack reaches you in 
time, we need you to register your Birthday Jam at 
least six weeks before your event. 

As always, if you have any questions, please 
don’t hesitate to ask us: jam@raspberrypi.org. UI 
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Vigibot, the ultimate web remote controller! 


Make your own robot, learn and have fun! 


Tablet Frame Kit Vigibot 


This kit is quite neat — it's part of an effort to create a Vigibot is a web-based control scheme for Raspberry 

low-cost computing solution that uses a Raspberry Pi for Pi-powered robots. It has some pretty great functionality 

schools and classrooms. It can even fit a breadboard on for all kinds of movement and actions, and includes a 

the back of it. It's also able to act as a stand for several nice display that can show a live view from a Raspberry 

other low-cost tablets, such as Amazon Fire. Pi camera - with an optional pan-and-tilt mechanism. 
kck.st/20gRvkF kek.st/2QuEvt3 


nE 


Sound up your - 
Raspberry H 


hifi 
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aspberry Jam 
vent Calendar 


Find out what community-organised Raspberry 
Pi-themed events are happening near you... 


01. Raspberry Jam Taiwan 


© Monday 30 December 

Z 2F, No.105, Sec. 1, Chongqing S. Rd, Taipei City, Taiwan 
> magpi.cc/yXigDK 

This Raspberry Jam will be focusing on uses of the 
Compute Module in solar power and more. 


02. Castro Valley Jam 

© Saturday 4 January 

Z Castro Valley Library, Castro Valley, CA, USA 

> magpi.cc/7nrwp2 

If you're interested in computer coding, you can tinker and 
code electronics at the Castro Valley Jam. 


03. Exeter Raspberry Jam 

© Saturday 4 January 

9 Exeter Library, Exeter, UK 

> magpi.cc/TYDo6 

A meeting for everyone interested in all things computers, 
microcontrollers, robotics, and making. 


04. Cornwall Tech Jam 

© Saturday 11 January 

9 Cornwall College Camborne, Camborne, UK 

> cornwalltechjam.uk 

For anyone interested in technology, of all ages and 
abilities. Ask questions and learn about programming. 
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05. South Devon Tech Jam 


© Saturday 11 January 
Z Paignton Library and Information Centre, Paignton, UK 
> magpi.cc/9vhGQ5 

A monthly informal and friendly session for anyone 
interested in technology, regardless of age or ability. 


06. WHPL Raspberry Jam 

© Monday 13 January 

Z Public Library, West Hempstead, NY, USA 

> whplibrary.org 

Learn to code in this Raspberry Jam using the library's 
brand new Raspberry Pi computers. 


07. Raspberry Jam Zelzate 

© Saturday 25 January 

Z Openbare Bibliotheek Zelzate, Zelzate, Belgium 

> magpi.cc/eUWnsH 

Everyone is welcome to start, share, and work on their own 
projects in a fun and relaxed atmosphere. 


08. Topsham Raspberry Jam 

© Saturday 25 January 

Z Nancy Potter House, Exeter, UK 

> magpi.cc/ysRxpX 

A Code Club turned Jam. You'll need to call the number at 
the League of Friends website to enrol. 


FULL CALENDAR 


Get a full list of upcoming 
events for January and 
beyond here: 


rpf.io/jam 
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FIND OUT 
Selbst ABOUT JAMS 


WI D Want a Raspberry Jam 
C ` ® D in your area? Want to 
L F start one? 
& D E jam@raspberrypi.org 
& e 
8 
Ki 


Z d 
E We've highlighted some of the areas & 


in need of a Jam! Can you help out? 


Raspberry Jam advice: 


Volunteers 


á á 0 ur volunteers have badges that say ‘Jam 


Maker’ on them. Sometimes we have 


lanyards. Tim and I tend to wear e Aë L 
our purple CamJam polo shirts. They weren’t P, L © Loi 
cheap, but we do stand out!” N TA > 
Zu Me A 
x SS ê bh 
$ X 


Michael Horne - Cambridge Raspberry Jam e Q ~ 
<L 


e Ce 
Zo raspserry Z 
Every Raspberry Jam is entitled to apply fora 


Jam starter kit, which includes magazine issues, dh 
printed worksheets, stickers, flyers, and more. GUIDEBOOK 
Get the book here: rpf.io/guidebook 
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Your E 


Letters 


Case necessity? 


Are cases for Raspberry Pi truly 
necessary? I understand they 
don’t really come with one and 
have seen many people use one 
outside of a case. 


Frankie via Twitter 


For the longest time with our 
very first Raspberry Pi, we didn’t 
use a case with it. Even now, if 
we’re putting together a quick 
thing for the magazine, we’ ll 
just have a Raspberry Pi sitting 
oose on a (wooden) table. So 

it’s not 100% necessary , but we 
always recommend getting a 
decent case — especially if your 
Raspberry Pi might sit in one 
place for a long time and feasibly 
get dusty. 


A The official case is very 
sleek and stylish, and 
we really like the new 
black version! 


Contact us! 


> Twitter @TheMagPi 


> Facebook magpi.cc/facebook 


> Email 
> Online 


magpi@raspberrypi.org 
raspberrypi.org/forums 
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A We hope to inspire you in 
the pages of The MagPi 


New user 


I’m getting my first Raspberry Pi for Christmas and am really 
excited by the possibilities. The only problem is that I feel a bit 
paralysed by choice! What should I do with my Raspberry Pi? 
Should I do many things? Will I need more? I hope you can help 
with these questions. 


Eddy via email 


It can be difficult to choose what to do with a Raspberry Pi once you 
have one! We’ve all been there ourselves. In this issue we have a few 
articles you might consider reading to get some ideas - first, (here's 
the 50 tools and tips feature (page 26). Here you can learn about any 
extra gear you need to start your maker journey, and maybe spark 
some ideas of what kind of project you want to make. Then we have 
the accessories and add-ons feature (page 68), which can give you 
advice on stuff to get for your Raspberry Pi, and the advanced kits and 
projects list (page 80) might give you some ideas as well. 

If all else fails, check out our latest Official Raspberry Pi 
Projects Book, Volume 5, for amazing ideas to help inspire you: 
magpi.cc/projects-books5. 


SD card requirements 


Whenever I see a sale for 
microSD cards online, I always 
feel like I should stock up on 
some for Raspberry Pi projects. 
Are there any limitations on 
size and speed and type of 
card, though? I’ve had issues 
in the past with cards getting 
corrupted in cameras and such, 
so want to make sure I don’t get 
any bad ones! 


Lou via email 


Most microSD cards will work 
fine with a Raspberry Pi. 
However, we usually advise to 
get 8GB or 16GB cards, and no 
smaller unless you know what 
you’re doing. Higher-capacity 
cards aren’t always necessary, 
and we find that the larger you 
go, the less likely they are to 
work with Raspberry Pi. For a 
list of tested cards, take a look 
at magpi.cc/sdcards. 

In our experience, though, 
you’ re better off getting 
a 16GB card and a big USB 
storage device. 


A It's best to check if a particular microSD 
card works with Raspberry Pi before 
buying it 
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A Super Crate Box is a great game 
from the creators of Luftrausers 


Raspberry Pi games 


I’ve read a lot of stuff over the years about emulating old systems 
on Raspberry Pi, and using it as a streaming box for your gaming 
PC. However, I was wondering if there were any games that were 
released for Raspberry Pi natively? 


Lee via Facebook 


It’s not a popular computer to release games on. There have been 
a few made for it, though. Most notably, a few indie games made 
in GameMaker: Studio were released on Raspberry Pi back in 2016 
(you can read more here: magpi.cc/gamemaker), and Doom runs on 
Raspberry Pi if you can find the right files for it. 

As well as GameMaker, Tilengine (tilengine.org) allows for games 
to be developed for Raspberry Pi, so if you fancy making anything 
yourself, check them out! 


D A few indie games were released on 
Raspberry Pi back in 2016 @ 
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THE BEST-SELLING MAG FOR PC HARDWARE, OVERCLOCKING, GAMING & MODDING 


PC HARDWARE 
ENTHUSIASTS 
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VISIT CUSTOMPC.CO.UK TO LEARN MORE 
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SAONE OF FIVE 


RASPBERRY PI 4 
& CASE BUNDLES 


Still after a Raspberry 
Pi 4? We have five to 
give away, complete 
with one of the stylish 
official black and grey 
cases as well. 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/raspberrypi4 


Terms & Conditions 


Competition opens on 18 December 2019 and closes on 30 January 2020. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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RASPBERRY PI 4 | 


MAKE A FUTURISTIC 
SUPER-SMART 
OCREEN 


THE MAGPI #90 
ON SALE 30 JANUARY 


Plus! 


Starter projects for 
the New Year 


The best Raspberry 
Pi 4 thermal cases TWITTER  @TheMagPi 


How to overclock FACEBOOK ` fb.com/MagPiMagazine 


your Raspberry Pi EMAIL magpi@raspberrypi.org 
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To anew era 


Rob Zwetsloot looks back at the decade of Raspberry Pi and The MagPi 


at the start of the decade and 
feeling proud of myself. I’d 
cobbled together a media PC from 
a load of spare parts and cheap 
components from eBay, running the 
XBMC-based Boxee. A big old tower 
sitting next to a TV with a wireless 
keyboard and (ball) mouse for control. 
This was the future. It couldn’t 
get better than this, even if it was 
over S-Video. 


| remember sitting in my home 


school education, bringing free 
computing resources to everywhere 
in the world, and being part of a new 
wave of makers. 


Eight years of Raspberry Pi 

It’s amazing to hear about the untold 
millions of Raspberry Pi computers 
sold over the last eight years, and 
even better seeing young folks enter 
the workforce who grew up with 

a Raspberry Pi. Yet still there are 


m it's funny how much can change in ten years 
- or in this case, about three D 


It’s funny how much can change 
in ten years — or in this case, about 
three, when a computer even cheaper 
and far smaller than my media PC 
came out: the humble Raspberry 
Pi Model B. I soon replaced the old 
machine with a Raspberry Pi with 
XBMC (now Kodi) installed and only 
recently upgraded it when Raspberry 
Pi 4 was released earlier this year. 

At the time I was amazed at how 
much Raspberry Pi could do. Little 
did any of us know just what it could 
achieve in the 2010s. A revolution 
in home robotics, helping overhaul 
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new, young makers popping up with 
incredible Raspberry Pi projects. 

Working on The MagPi for the 
last four years has been a dream as 
well. Helping to highlight amazing 
projects, amazing events, and 
amazing people throughout the 
community and across the globe, and 
there’s no sign of that slowing down 
any time soon. 

I have many personal highlights 
from the last 50+ issues I’ve worked 
on, but I always come back to one: 
writing the main feature that went 
along with issue 40 — the Raspberry 


Pi Zero launch issue. We were all 
blown away by the response to its 
release, and I’m very proud that we 
were the first magazine to havea 

free computer on the cover. I still 

get emails asking if we have any left 
(not for several years, unfortunately), 
and Raspberry Pi Zero still amazes 
everyone I introduce it to. 


Welcome to tomorrow! 
Heading into 2020, I’m even more 
excited about the future of Raspberry 
Pi, making, and everything related to 
it. What incredible new projects will 
become trivial builds by 2030? How 
many more young people and kids 
will be enamoured with Raspberry 
Pi? Will Raspberry Pi go deeper into 
space? And will my media PC get 
smaller and better still? 
Whatever happens, UU be here 
to share and celebrate all that the 
community does with Raspberry Pi. 
Let’s make the next decade amazing. Hl 


Rob Zwetsloot 


Rob is amazing. He's also the Features 
Editor of The MagPi, a hobbyist maker, 
cosplayer, comic book writer, and 
extremely modest. 
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Perfect option for your DIY or high-volume commercial projects 


Fits all kinds of HATs 
Ideal PoE HAT case 


Use with HAT or Pi alone 
Simple and professional 


Rapid, tool-free assembly 
GPIO cable pass-through 


Two wall mount options 
Well ventilated 


Designed and manufactured in North America 
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HAPPY ` 
HOLIDAYS 


